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GLOSSARY OF TERMS 
USED IN THIS MANUAL 



ABSOLUTE SYSTEM - The binary memory image of the 
Real-Time Executive III System (stored on logical unit 2). 

AUXILIARY SUBCHANNEL - The subchannel is optional 
and when used is assigned to logical unit 3. (The binary 
memory image of RTE-III does not reside on the auxiliary 
subchannel.) The auxiliary subchannel has the same status 
as the system subchannel in that it is treated as a logical 
extension of the system subchannel. 

CLASS I/O - A rnethod of communication between a set 
of programs or devices that may be synchronous or asynch- 
ronous with respect to each other, in order to provide paral- 
lel processing of information. Class I/O allows a program 
to continue processing after initiating the operation, with- 
out requiring that it wait for completion (I/O without wait). 

DEVICE DOWN - Relates to the state of a peripheral I/O 
controller or device. When the controller or device is down, 
it is no longer operable. Also, refers to the operator com- 
mand DN, which sets the controller or device down. 

DEVICE UP - Relates to the state of a peripheral I/O 
controller or device.. When the controller or device is up, 
it is operable. Also, refers to the operator command UP, 
which sets the controller and all associated devices up after 
being set down. 

EQT (EQUIPMENT TABLE) - A table in memory associ- 
ating each I/O interrupt location (I/O controller) with a 
particular software processing routine (driver). The status 
of the I/O controller and information about any current 
request is also stored in its EQT. 

GLOBAL TRACKS - Global tracks are a subset of system 
tracks and are accounted for in the track assignment table. 
Any program can read/write or release a global track 
(i.e., programs can share global tracks). 

I/O CONTROLLER - A combination of I/O card, cable, 
and (for some devices) controller box used to control one 
or more I/O devices on a channel. 

I/O DEVICE - A physical unit defined by an EQT entry 
(I/O controller) and subchannel. 

LG AREA - A group of tracks used to temporarily store 
the relocatable output of an assembler, compiler, or file 
manager prior to relocation by the loader. 

LOGICAL MEMORY - Logical memory is the 32K (maxi- 



mum) address space described by the currently enabled 
memory map. If the System Map is enabled, it describes 
those areas of physical memory necessary for the operation 
of the operating system and does not change during system 
operation. When the User Map is enabled, it is updated to 
describe those areas needed by programs when it is to be 
executed. DMA Maps describe buffers during DMA 
transfers. 

LU (LOGICAL UNIT) NUMBER - A number used by a 
program to refer to an I/O device. Programs do not refer 
directly to the physical I/O device channel number, but 
through the LU number which has a cross reference to the 
device. This allows I/O devices to be changed without hav- 
ing to change the programs. 

MOVING HEAD DISC DRIVE - Consists of a mechanism 
to rotate one or two discs, one permanently mounted and 
the other removable. There is one head per recording sur- 
face that is attached to a movable arm. The head is moved 
to the addressed track by means of an actuator driving the 
arm and head. 

PARTITION - A block of memory with a fixed size (in 
pages) and identification number located in the disc resident 
program area. The user may divide up the disc resident pro- 
gram area into as many as 64 partitions classified as a mix- 
ture of Real-Time and Background, all Real-Time, or all 
Background. Disc resident programs run in partitions. 

PERIPHERAL SUBCHANNEL - Peripheral subchannel is 
a subchannel that is available to the user for read/write 
operations but for which RTE-III does not manage the sub- 
channel nor maintain a track assignment table. (The file 
manager can, however, use peripheral subchannel tracks.) 
A peripheral subchannel must have a logical unit number 
assignment greater than 6. 

PHYSICAL MEMORY - Physical memory is all memory 
available to the user. Physical memory includes the operat- 
ing system, libraries, common, system available memory, 
and all partitions. 

PROGRAM SWAPPING - Where disc resident program A 
is removed from a partifion and stored on the disc in its cur- 
rent state of execufion, and program B is placed (for execu- 
tion) in the partition formerly occupied by program A. 
Program A is eventually returned to either the same or a dif- 
ferent partition to continue. 

REAL-TIME EXECUTIVE III - The total operating system 
comprised of the memory resident modules (e.g., EXEC, 
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SCHED, RTIOC), plus I/O drivers, and various tables. 
Abbreviated RTE-III. 

RESOURCE MANAGEMENT - Resource management, or 
numbering, is a feature that allows the user to manage a 
specific resource shared by a particular set of programs, so 
that no two of these programs use the resource at the same 
time. 

SCRATCH AREA - A number of disc tracks used during 
off-line system generation for temporary storage of the 
relocatable binary code of RTE-III. 

SUBCHANNEL — One of a group of I/O devices connected 
to a single I/O controller. For example, RTE driver DVRxx 
can operate more than one magnetic tape drive through sub- 
channel assignments. In the case of moving head discs, 
contiguous groups of tracks are treated as separated sub- 
channels. For example, a 7905 disc platter may be divided 
into four subchannels. 



SYSTEM SUBCHANNEL - The disc subchannel assigned 
to logical unit 2 that contains the binary memory image of 
the Real-Time Executive III System. 

SYSTEM TRACKS - All those subchannel tracks assigned 
to RTE-III for which a contiguous track assignment table is 
maintained. These tracks are located on logical unit 2 (sys- 
tem), and 3 (auxiliary). 

TIME-OUT - Relating to the state of a peripheral device. 
When the device has timed-out, it is no longer operable. 
Also (noun), the parameter itself. Amount of time RTE-III 
will wait for the device to respond to an I/O transfer com- 
mand before RTE-III makes the device inoperable. 
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SECTION I 
GENERAL DESCRIPTION 



INTRODUCTION 

The Hewlett-Packard Real-Time Executive with dynamic 
mapping (RTE-III) is a multiprogramming operating system 
that supports user access to more than one miUion words 
of main memory. Through a unique scheme of memory 
management and mapping, the central processor unit (CPU) 
can be expanded from a maximum of 32K words of 
"logical" memory to 1024K words of "physical" memory. 
"Logical" memory describes the actual 32K address space 
imposed by the 15 -bit address length used in HP 2100 
Series Computers, Note that 32K is also the minimum 
amount of memory that RTE-III will operate in. The term 
"Physical" memory describes all of memory available to 
the user through the memory management and mapping 
scheme. The RTE-III system takes care of all addressing 
and mapping for you (except in the case of privileged 
drivers which are discussed in Section V). With the excep- 
tion of those features listed in Appendix I, RTE-III is 
backward compatible with RTE-II. Most programs written 
for a previous HP Real-Time executive system, and using 
documented system functions, will operate correctly under 
RTE-III. 

This book serves as a reference manual and programmer's 
guide to the RTE-III system. You should be famiUar with 
operating procedures of the HP 21 MX Series Computers and 
other system related hardware, and in addition, with soft- 
ware programming Languages as presented in the Hewlett- 
Packard FORTRAN (02116-9015), FORTRAN IV (5951- 
1321), ALGOL (2116-9072), and 21MX Assembler 
(24307-90014) Programmer's Reference Manuals. 

HARDWARE 

The RTE-III system operates with the minimum hardware 
configuration shown in Table 1-1 . 

SOFTWARE 

The RTE-III software is listed in 92060B Software Number- 
ing Catalog, part number 92060-90019. 



Table 1-1. Minimum RTE-III System 



HP 21MX Computer with 32K Memory 
Time Base Generator 
Dual Channel Port Controller (DCPC)* 
Dynamic Mapping System 
Memory Protect 
System Console Device 
High Speed Disc Storage 

HP Mini Cartridge Subsystem or High Speed Paper 
Tape Reader 

*Note that DCPC provides the direct memory access 
(DMA) capability. 



MEMORY MANAGEMENT 

The Real-Time Executive, using the Dynamic Mapping 
System, provides the capabihty of addressing memory con- 
figurations larger than 32K. Using DMS, the user has the 
capabihty of addressing up to 1024K words of physical 
memory. 

The capability of addressing more than 32K is accompUshed 
by translating memory addresses through one of four 
"memory maps"; a memory map being defined as 32 hard- 
ware registers that provide the interface between the 32K 
logical memory and physical memory. 

Note that all memory map addressing is done internally by 
the system and is transparent to the user. The following 
brief explanation of the addressing and mapping process 
provides a general understanding of the overall operation of 
the system. For a more detailed description of the Dynamic 
Mapping System, refer to the 21MX Computer Reference 
Manual, HP Part No. 02108-90002. 

ADDRESSING 

The basic addressing scheme of the computer uses a 15 -bit 
number which describes a location in memory numbered 
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to 32767 (refer to Figure 1-1). The 32768 (32K) loca- 
tions are grouped into 32 pages, each page containing 1024 
(IK) words. The scheme takes the 15-bit address and splits 
it into two parts. The upper 5 bits (bits 10-14), become the 
logical page number, an index pointing to one of the 32 
registers within a memory map (only one of the four maps 
can be enabled at a time). The lower 10 bits point to a 
relative address (or offset) within the destination page and 
do not require translation. Thus, when the address is con- 
verted, the index is used to determine which of the 32 
registers of the currently enabled map has the 10 bit 
physical page address. This page address is then concate- 
nated to the relative address to provide the ultimate 20 bit 
address in physical memory. 
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Figure 1-1. RTE-III Address Scheme 



MAPS 

There are four memory maps managed by the system ^ the 
User Map for describing user programs, the System Map for 
describing the system and system available memory, and 
two Dual Channel Port Controller (DCPC) maps called 
Port A Map and Port B Map for describing the initiator of 



the direct memory access (DMA) transfer. At any one 
instant only one memory map is enabled. This map 
describes the 32K logical address space at that instant in 
time. Either the System or User Map will be enabled unless 
a DMA transfer is in progress. If a DMA transfer is taking 
place, the appropriate Port Map is instantaneously enabled 
each time a word is transferred between the DCPC and 
main memory. 

SYSTEM MAP. This map, which is automatically enabled 
whenever an interrupt occurs, is loaded by the system dur- 
ing system initialization and is never changed. It describes 
the logical address space which includes the RTE-III system 
and its base page, the memory resident Ubrary, and system 
available memory. The inclusion of common in the system 
map is a generation option for the benefit of users with 
privileged drivers. Refer to Section V for more information 
on privileged drivers. 



USER MAP. Associated with each disc resident program is 
a unique set of page addresses that describe the logical 
address space for that program. These page addresses 
describe the memory occupied by the system, the memory 
resident hbrary, common (if the program uses it), the pro- 
gram's base page, and the program. All memory resident 
programs use a single set of page addresses describing the 
system base page, the system, the memory resident hbrary, 
common, and the memory resident program area. Each 
time a new memory or disc resident program is dispatched, 
the system reloads the User Map with the appropriate set 
of page addresses. The User Map therefore, provides the 
interface between logical memory and physical memory. 

PORT A MAP. Direct memory access is a software assign- 
able direct data path between memory and a high speed 
peripheral device. This function is provided by the 21 MX 
Dual Channel Port Controller (DCPC). There are two 
DCPC channels, each of which may be assigned to operate 
with an I/O device. The Port A Map is automatically 
enabled when a transfer on DCPC channel one takes place. 
It must be reloaded by the system each time the channel is 
assigned so that the caller's buffer is described. Having 
separate maps for DCPC facihtates multi-programming since 
DCPC may be accessing one program's buffer while another 
program (in a different area of physical memory) is using 
the CPU under the User Map (i.e., when one program is 
using DCPC, another program can be executing). 

PORT B MAP. This map is handled the same as the Port A 
Map except that it apphes to DCPC channel two. 

PHYSICAL MEMORY 

At generation time, the user plans the physical memory 
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allocations shown in Figure 1-2 and then loads the system 
components in the most efficient configuration. The user 
determines the size of system available memory, the num- 
ber and size of each partition, the size of common, and the 
size and composition of the resident Ubrary and memory 
resident program area. 

In Figure 1-2 the areas shown are used as foUows; 

• System Base Page ~ contains system communication 
area and is used by the system to define request 
parameters, I/O tables, scheduhng hsts, operating 
parameters, memory bounds, etc. System and library 
hnks, memory resident program links, and trap ceUs 
are also located on the system base page. The base 
page links for memory resident programs are not 
accessible by disc resident programs and therefore 
may not be shared. System and library hnks and the 
system communication area are accessible to all 
programs. Partition base pages, used for disc resident 
program hnks, are described below with partitions. 
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Figure 1-2. Physical Memory Allocations 



System - Contains the absolute code of the type 
system modules (e.g. RTIOC, SCHED, EXEC), and 
drivers plus tables that form the nucleus of the 
operating system. 

Memory Resident Library - Contains those re-entrant 
or privileged library routines which are used by the 



memory resident programs (type 6) or which are force- 
loaded (type 14) at generation time. 

• Common — This area is divided into three subareas: 
The Subsystem Global Area (SSGA), the Real-time 
Common area, and the Background Common area. 
SSGA is used by Hewlett-Packard software subsystems 
for buffering and communications. The Real-time and 
Background subareas are reserved for user-written 
programs that declare COMMON. 

• Memory Resident Programs — This area contains all 
type 1 programs that were loaded during generation. 

• System Available Memory - This is a temporary 
storage area used by the system for Class I/O and 
reentrant I/O (refer to Section III), and automatic 
buffering. 

• Partition - This is an area set aside by the user where 
his disc resident program will run. Each partition has 
its own base page that describes the linkages for the 
program running in the partition. Up to 64 partitions 
are ahowed, subject to available main memory. 

AU of the above areas are estabUshed during system genera- 
tion. Refer to Section VI for more information on sizes 
and boundary determination. 

LOGICAL MEMORY 

Logical memory is the 32K (maximum) address space 
described by the currently enabled memory map. If the 
System Map is enabled, logical memory includes the operat- 
ing system and its base page, the memory resident library, 
and system available memory. It may also include common 
if that option was chosen at generation time. If the User 
Map is enabled for a disc resident program, logical memory 
includes the operating system, the memory resident hbrary, 
common (if it is used by the program), and the currently 
executing program and its base page. The logical memory 
of a memory resident program includes the system base 
page, the operating system, the library, common and all 
memory resident programs. Port Maps are enabled on a 
word-at-a-time basis during DCPC transfers. They describe 
the logical memory containing a data buffer. A Port Map 
win be the same as either the System Map or the map of the 
program being serviced, depending on type of I/O call. 

Figure 1-3 shows four configurations of the 32K logical 
address space. The first configuration is how this space 
appears under control of the System Map. Note that there 
is always a total of 32 pages to be divided up; however, the 
particular boundaries shown for the various parts are only 
examples. Your system could be larger or smaller. The 
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second configuration is how the logical address space 
appears under control of the User Map when a memory 
resident program is executing. The third configuration is 
how the logical address space appears under control of the 
User Map when a disc resident program using common is 
executing. The fourth configuration is how the logical 
address space appears under control of the User Map when a 
disc resident program not using common is executing. 
Many programs wiU not require a full 32K space, and un- 
needed pages will be READ/WRITE protected in the user 
map (shown in Figure 1-3, configuration 3). 



SYSTEM DESCRIPTION 

MULTIPROGRAMHING 

The RTE-III System is a multiprogramming system that 
allows several programs written in Real-Time Assembler, 
ALGOL, or FORTRAN languages, to operate concurrently, 
each program executing during the unused central processor 
time of the others. 

Up to 256 programs may be defined by ID segments at one 
time. An ID segment is a table that describes the program. 
Refer to Appendix A for more information. Note that 
additional programs may be relocated and then saved by 
the file manager. This increases the number of readily 
accessible programs indefinitely. 

RTE-III has a scheduling module that decides when to 
execute the compefing programs, which may be scheduled 
by time intervals, an external event, an operator request, or 
"by another program. All input/output and interrupt proc- 
essing is controlled by RTE-III except for privileged inter- 
rupts which circumvent the system for a faster response. 
When a program requests a nonbuffered I/O transfer, the 
system places the program in an I/O suspended state, 
initiates the I/O operation, and starts executing the next 
highest priority scheduled program. When the I/O transfer 
is complete, the system reschedules the suspended program 
for execution. When a program requests a buffered I/O 
transfer, the system does not suspend the program. 

There are two areas available to the user for execution of 
his programs, the memory resident program area and the 
disc resident program area. Note that the number of pro- 
grams which may be resident in memory at one time is the 
sum of the number of memory resident programs and the 
number of partitions defined (up to 64). This greatly mini- 
mizes the dispatching time for disc resident programs which 
are in memory, because it is much faster to switch maps 
than it is to perform a swap between main memory and 
disc. 



MEMORY RESIDENT PROGRAM AREA 

The memory resident program area is that area where 
programs are always resident and is intended for high 
priority tasks requiring quick response time to real-time 
conditions and for often used programs which are very 
small. 

DISC RESIDENT PROGRAM AREA (PARTITIONS) 

The disc resident program area is divided up into partitions 
which are defined as fixed blocks in memory estabhshed at 
generation time. The user may specify how many partitions 
(up to 64) are in the system, what type each partition is 
(Real-Time or Background), and the size (pages) of each 
partition. 

The number of partitions depends on the amount of 
physical memory available. Partition types can be specified 
as a mixture of real-time and background, all real-time, or 
all background. A program can be assigned at load time to 
run in any partifion that is large enough to accommodate it. 
There can be several programs assigned to the samij parti- 
tion, but only one program can run in that partition at a 
time. If a program is not assigned to a parfifion, then by 
default, real-time programs will run in real-time partifions 
and background programs in background partitions. If only 
one type of partition is defined, all programs will run in 
that type partition. 

When a program is not assigned to a partition, it will run in 
the smallest free partition that will accommodate it. If no 
free partition exists, the program will be swapped with the 
lowest priority swappable program that occupies a partition 
large enough to accommodate the new program. 

BASE PAGE 

In RTE-III, the system, and each disc resident program has 
its own base page. The system base page contains the sys- 
tem communication area, system and hbrary links, memory 
resident program Hnks and trap cells for interrupt process- 
ing. The disc resident program base page contains the sys- 
tem communication area, system and Hbrary Hnks, and disc 
resident program links. The base page communications area 
(see Appendix A) and the system and resident Hbrary Hnks, 
which are located in physical page 0, wiU be common to aU 
base pages. 

Instructions are channeled to the proper physical base page 
by being either above or below a base page fence set during 
generation. The base page fence not to be confused with 
the memory protect fence, is set to be immediately below 
the communication area, the system links and the library 
links. If a base page address is above the fence it is 
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Figure 1-3. RTE-III 32K Logical Memory Configurations 
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channeled to physical page 0. If it is below the fence it is 
channeled to the base page described by the currently 
enabled map. 

COMMON 

The real-time and background commons along with 
subsystem global area occupy a contiguous area in memory 
and are treated as a single group for mapping purposes 
(refer to Figure 1-3). The use of common is optional on a 
program basis; that is, any program may use real-time com- 
mon, background common or no common. If the program 
declares common, both common areas and the subsystem 
global area wih be included in the User Map. If the program 
does not use common it is not accounted for in the User 
Map, thereby providing the user a larger program area in the 
32K logical address space. Note that memory resident pro- 
grams always include common in their map. 

REAL-TIME AND BACKGROUND COMMON. If a pro- 
gram declares at least one word of common, the use of 
real-time or background common is selected by program 
type (at generation) or parameters with the on-line loader. 
Program types are summarized in Appendix I. Note that 
the memory protect fence protects areas below the selected 
common. 

These system common areas are not to be confused with 
the local common area which may be specified for programs 
loaded on-line. The system common areas are sharable by 
programs operating in different partitions, whereas the local 
common area is appended to the program (i.e. it will be in 
its partition) and is accessible only to that program, its 
subroutines, and its segments. 

SUBSYSTEM GLOBAL AREA. The subsystem global area 
consists of all type 30 modules input to the generator. 
Accessed by entry point (using EXT statements) rather than 
common declarations, SSGA provides multiple communica- 
tion and buffer areas for Hewlett-Packard subsystems. 
SSGA access is authorized by program type at generation 
(see Appendix I) or through special parameters to the on- 
line loader. Programs authorized for SSGA access include 
the common area in their maps and have the memory pro- 
tect fence set below SSGA. 

MEMORY PROTECTION 

Memory protection between disc resident program partitions 
and between disc and memory resident programs is pro- 
vided by the Dynamic Mapping System. A program cannot 
access a page not included in its logical memory either 
directly or through a DMA transfer. Since many programs 
do not use all of the possible 32K logical area, unused 



logical pages above the program are READ/WRITE pro- 
tected and do not necessarily have counterparts in physical 
memory. 

A different form of protection is required for the system, 
library, and (optionally), common. The memory protect 
fence provides this protection by preventing stores and 
jumps to locations below a specified address. All possible 
fence positions are shown in Figure 1-3. 

The memory protect fence applies to the logical address 
space where addresses are compared to the fence before 
translation. If a disc resident program does not use any of 
the common areas, the memory protect fence is set at the 
bottom of the program area. Similarly, for a memory 
resident program not using common, the memory protect 
fence is set at the base of the entire memory resident area. 

For programs using common, all of logical memory includ- 
ing common is mapped and the fence is set at one of three 
possible locations, depending on the portion of common 
being used. A hierarchy of protection is thereby estabhshed 
within common due to their physical locations. Background 
common is the least protected (any program using any 
common can modify it) and SSGA is the most protected 
(only programs authorized for SSGA access can modify it). 
Figure 1-4 expands the common area and shows these three 
fence settings as (a), (b), and (c). 

Figure 1-4 also shows a potential problem area marked "?" 
which includes those words from the top of common to the 
next page boundary. This area could include one or more 
memory resident programs and/or part of System Available 
Memory. Any program using common could potentially 
destroy the contents of this area. Aligning the top of com- 
mon at the next page boundary is a generation option that 
expands the size of background common while eliminating 
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this problem. The same option is available for the boundary 
between memory resident programs and system available 
memory where a simiUar problem occurs. 

PROGRAM TYPES 

As described above, there are two areas for program execu- 
tion, the memory resident area and the disc resident area. 

MEMORY RESIDENT PROGRAMS 

The memory resident area is intended for high priority tasks 
requiring rapid response to real-time conditions and external 
events and for very small programs which execute very often. 
Memory resident programs are loaded into the system during 
generation. 

DISC RESIDENT PROGRAMS 

Disc resident programs run in partitions and require more 
time for dispatching than memory resident programs do 
since a partition must be allocated and the program loaded 
from the disc. There are two types of programs that run in 
the partitions, real-time programs and background pro- 
grams. To minimize the time necessary to locate a partition 
for a particular program the capabilities for defining two 
types of partitions and for assigning programs to partitions 
have been included in the system. These capabihties mini- 
mize the number of programs competing for the same 
partitions. The real-time programs are usually user pro- 
grams that have been compiled to handle external events. 
These new programs can be compiled, tested, and placed 
into operation without any paper tape output and little 
operator intervention. Background disc resident programs 
are usually compilers, assemblers, and editors used to 
create new programs to control future processes while the 
real-time programs handle external events. Background disc 
resident software usually includes the following items. 

SYSTEM COMMAND PROGRAM ($$CMD). A system 
program scheduled by SCHED for the processing of the 
LU, EQ, and TO system commands. 

ASSEMBLER. Accepts source programs in HP Assembler 
Language and outputs a relocatable binary program to LG 
disc tracks and/or punches the program on paper tape. 

FORTRAN. Compiles FORTRAN programs and provides 
additional statements for real-time control. Same output 
options as Assembler. 

FORTRAN IV. Compiles source programs written in 
FORTRAN IV with extended precision arithmetic and bit 
manipulation via logical expressions. 



ALGOL. Compiles source programs written in HP ALGOL. 

INTERACTIVE EDITOR (EDITR). EDITR is an on-line 
editor that provides the user with a powerful editing tool. 
The user moves a pointer (pending line to be edited) 
through the file, forward or backward skipping lines if 
desired, and editing only where desired. 

RELOCATING LOADER. Provides on-line loading of user 
generated programs. Programs can be debugged and tested 
in background and then loaded to run in either a real-time 
or disc resident partition. 

ON-LINE GENERATOR. Provides a way to configure a 
new operating system on-line under control of your 
current operating system. 

SWTCH. Transfers a new operating system from a file 
created by the On-Line Generator to a disc subchannel. 

DEBUG. When user program is loaded with relocating 
loader, DEBUG can be appended to each main program and 
segment to provide checkout. When the program is run, 
DEBUG takes control of program execution and requests 
instructions from the keyboard. 



DISC RESIDENT PROGRAM SIZE 

Disc resident programs run in partitions and partitions 
always begin on a page boundary. Referring to Figure 1-3, 
it can be seen that the program (starting with the second 
page of the partition) is placed in logical memory immedi- 
ately following the background system common if the 
program uses common, or immediately following the library 
if not. When the program runs, the user program only sees 
that area of memory described by its map. 

The end of logical memory is determined by the number of 
pages needed to liold the main program, its subroutines, and 
its largest overlayable segment. This, plus a base page, also 
determines the minimum acceptable partition size for the 
program. If a program needs a dynamic buffer area or 
symbol table space (EDITR, for example), the program size 
in pages must be increased during generation or when load- 
ing with the relocating loader to make it appear larger. This 
insures enough buffer space for the program to use, since 
only this number of pages will be mapped into the program 
area of the logical address space. If the partition allocated 
is larger than the program, the remaining pages are not a 
part of its logical memory, and are therefore inaccessible. 
This is necessary to allow a program to be freely swapped 
between disc and any suitable partition during its operation. 
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SUBROUTINES 

Each user program (main or segment) consists of a primary 
routine, containing the transfer point for entry into the 
program from RTE-III and optionally a series of subrou- 
tines. In Assembly Language, the transfer point is given by 
the label appearing as the operand of the END statement. 
In FORTRAN, the transfer point is the first executable 
instruction in a routine containing a PROGRAM statement. 
The primary routine is linked with its subroutines (which 
are defined by external references within the primary rou- 
tine) when it is loaded. 

The Relocatable Library consists of a number of subroutines 
that may be hnked to user programs. (See Section IV, 
Part 6.) Each subroutine is either re-entrant, privileged, or 
utility. These terms are defined as follows: 

• Re-entrant -- Code is shared and the routine can be 

interrupted. 

• Privileged - Cannot be interrupted except by privi- 

leged I/O. 

• Utihty - Separate copy of the routine must be 

appended to each caUing program. 

The classification of a specific routine is based on its 
function, word length, and execution time. A single copy 
of a re-entrant or privileged subroutine may be used by 
more than one program if it is included in the resident 
library. (See Figure 1-2.) If called by a disc resident pro- 
gram and not in the resident Hbrary, a copy of the re-entrant 
or privileged subroutine is appended to the calling program 
during relocation. 

Subroutines which cannot be shared because of internal 
design or I/O considerations are utility subroutines, and a 
copy of the utihty subroutine is appended to each primary 
routine, whether memory or disc resident, that calls it. 
RTGEN stores all library programs that are not included in 
the resident library on the disc in relocatable format (as 
utihty routines to be used by the Relocating Loader). Note 
that utility subroutines may call a re-entrant or privileged 
subroutine but the reverse is not permitted. 

The classification into which a particular subroutine fits is 
determined by program type at generation (See Appendix I). 

PROGRAM SCHEDULING 

Scheduling of all programs is done by a scheduMng module 
in the memory resident system, and is based on priority. 
Programs may be scheduled for execution by an operator 



request, a program request, a device interrupt, or the com- 
pletion of a time interval. RTE-III can be generated such 
that one program is automatically scheduled each time the 
system is loaded from the disc. Whenever programs conflict 
because of simultaneous demands for execution, the system 
decides in favor of the highest priority program. Priorities 
are assigned by the user during generation or on-Hne load- 
ing, and may be changed by an operator request. 

In RTE-III, the highest priority program scheduled for 
execution executes first. Then, if that program suspends 
execution (e.g., waiting for I/O to complete), the next 
highest priority scheduled program executes. 



Programs that were removed from the executing state to 
wait for an event to occur before re-scheduling are in the 
suspended state. Programs which are not currently in either 
the scheduled, executing, or suspended state are in the 
dormant state. Programs may thus be in one of four states: 

• Executing 

• Scheduled 

• Suspended 

• Dormant 



The status field in the ID segment (see Appendix A) records 
the state of the program. 

Programs may be suspended for several reasons: 

Waiting for the completion of an I/O operation 

Waiting for the availability of needed memory space 

Waiting for the completion of a disc allocation 

Waiting for the completion of a program scheduled 
by the suspended program 

The operator has requested that a program be 
suspended 

The program has requested that it be suspended 

Waiting for a logical unit number to be unlocked 

Waiting for a resource number to be unlocked 

Waiting for a class number 
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TIME SCHEDULING 

Current time is updated every ten milliseconds. Whenever 
this occurs, a time hst of programs is checked. Any pro- 
grams scheduled to execute at that time are placed in the 
scheduled Hst. Time scheduling is based on multiples of 
hours, minutes, seconds, and tens of miUiseconds. 

PRIORITY LEVEL 

Program priority determines the order of a program in the 
scheduled and I/O suspended states. The priority field of 
the ID segment (see Appendix A) records the priority of 
the program. Priorities range from (the highest, reserved 
for system programs) to 32767 (the lowest). The priority 
of any program can be changed by an operator request, and 
more than one program can be at the same priority. 

For each program state except dormant, RTE-III maintains 
an ordered list of the programs in that state, connecting the 
ID segments according to the priority of the programs. 
There are two types of hsts: 

• Scheduled 

• Suspended 

The base page communication area (see Appendix A) con- 
tains the pointers to the ID segment of the first, or highest 
priority, program in each list. Then, the linkage field of 
each ID segment contains location of the next ID segment 
in the list. There is one scheduled Ust and five types of 
suspension Usts: 

I/O suspension hsts (one for each device) 

Memory availability list 

Disc aUocation list 

Operator suspension hst 

General wait hst 

PROGRAM INITIATION AND SWAPPING 

Program initiation requires that a copy of the program be 
present in main memory and that the ID segment be placed 
in the scheduled list. A disc resident program must be trans- 
ferred into memory while a memory resident program is 
always immediately available. When a disc resident program 
is scheduled, a partition is selected by the system. If an 
uncompleted program already occupies that partition, the 
uncompleted program is transferred out to the disc and 
saved in its uncompleted and modified state, the new pro- 



gram is transferred into its place. This operation is caUed 
swapping. During the swap a check is made to see if work 
can be done by another program already residing in main 
memory. I/O operatons continue concurrently. 

Multiple-partitions combined with background swapping 
make it possible for multiple users to take advantage of the 
program development facihties of the RTE-III system. For 
example, one person can be editing a program in one parti- 
tion while another is entering, compihng, assembling, or 
loading a program in another partition. Multiple partitions 
greatly decrease the amount of time-consuming swapping. 
Unless assigned to a specific partition, there is no require- 
ment that a swapped-out program be swapped back into the 
same partition. 

INPUT/OUTPUT CONTROL 

A system module called RTIOC is responsible for processing 
normal system interrupts (non-privileged) and input/output 
operations. Section V describes the I/O structure of the 
RTE-III system in detail, emphasizing I/O drivers, and 
privileged interrupt processing. 

INTERRUPT PROCESSING 

AU interrupts, except privileged interrupts and power fail, 
cause a transfer to RTIOC which is responsible for saving 
and restoring the various registers, analyzing the source of 
the interrupt and calhng the appropriate processing routine. 

An interrupt table, containing entries ordered by hardware 
interrupt priority, indicates the correct processor routine 
for each interrupt. Processors that respond to standard sys- 
tem interrupts (real-time clock routine, memory protect, 
standard I/O drivers) are entered directly by RTIOC. 
Processors that respond to user-controlled devices or inter- 
rupt sources are normal user programs and are placed in the 
scheduled hst and executed according to program priority. 

When an interrupt occurs, the instruction in the word cor- 
responding to the I/O channel number is executed. For aU 
active interrupt locations, except privileged interrupts and 
power fail, this instruction is a jump subroutine indirect 
(JSB, I). 

PRIVILEGED INTERRUPT 

RTE-III offers a special privileged interrupt feature, using 
an optional privileged interrupt control card and the hard- 
ware priority structure of the computer. A privileged inter- 
rupt by-passes normal interrupt processing to achieve faster 
response for interrupts having the greatest urgency. Privi- 
leged drivers must save and restore the state of the machine. 
See Section V for details. 
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INPUT/OUTPUT PROCESSING 

RTIOC allocates DCPC channels for I/O devices requiring 
direct memory access (DMA), provides for referencing I/O 
devices by logical unit number (rather than directly by 
equipment table entry number of the I/O channel), queues 
program I/O requests for a particular device by priority of 
the calling program, and provides automatic output buffer- 
ing, when specified. 

I/O drivers are under control of RTIOC for initiation and 
completion of program-requested I/O operations; they 
provide simultaneous multi-device control. 

Program requests for I/O are made by EXEC calls which 
specify the type of transfer and device desired. All input/ 
output operations occur concurrently with program execu- 
tion; one program is executed while others receive I/O 
service. If a transfer is unbuffered, the requesting program 
is suspended and the next lower priority scheduled program 
is executed during the suspension. Class and buffered trans- 
fers aUow the immediate continuation of the requesting 
program. 

CLASS INPUT/OUTPUT OPERATIONS 

Under class I/O, input-output operations for a program are 
performed concurrently with its execution. This unique 
scheme within the RTE-III system also allows program-to- 
program communication and program-to-multiple-device 
operation. The term "class" as used in this context is 
likened to an account which is owned by one program but 
may be used by a group of programs. The maximum num- 
ber of classes is established during system generation. Once 
the numbers are established the system keeps track of them 
and assigns one (if available) to the calling program when a 
class I/O call is made. Once the number has been aUocated, 
the program can keep it as long as desired and use it to 
make multiple class I/O calls. When the program is finished 
with the number it should be returned to the system for 
use by some other programs. 

LOGICAL UNIT ^OCK 

The RTE-III system provides for temporary exclusive 
assignment of I/O devices to specific user's programs. This 
can be used to assure that a low-priority program completes 
its use of a printer, for example, without having that use 
preempted by a higher-priority program. 

RESOURCE MANAGEMENT 

Within RTE-III, any element that can be accessed by a 
user's program is regarded as a resource. A resource thus 
can be an I/O device, file, program, or subroutine. Occa- 



sionally, the user may want to manage a specific resource 
shared by a particular set of programs so that no two of 
these programs can use the resource at the same time. To 
accomphsh this type of resource management the programs 
involved must mutually cooperate. For example, PROGB 
must not access a particular file when PROGA is using it. 
Both programs should include provisions for a hand-shaking 
arrangement overseen by the system when these programs 
are being executed concurrently. Under this arrangement, 
when PROGA has exclusive access to the file and PROGB 
attempts to access the same file, this access will be denied. 
PROGB will be suspended until PROGA releases its exclu- 
sive access. Then, PROGB can resume execution and access 
the file. (It is important to realize that as long as PROGB 
is suspended, it not only cannot access the file — it cannot 
perform any operations.) For more information refer to 
Section III. 

The hand-shaking arrangement between programs is based 
upon an arbitrary resource identification number (RN) 
made available to programs. Within the cooperating pro- 
grams the RN is related to a particular resource through the 
structure of the statements making up each program. When 
a program seeks exclusive access to a resource, it requests 
the system to lock the related RN. (This request is granted 
only if no other program has already locked the RN; other- 
wise, the requesting process is suspended until the RN is 
released.) When it is finished with the resource, the pro- 
gram requests the system to unlock the RN so that other 
programs can lock it. 

A RN is not a physical entity. Furthermore, it is not 
logically assigned to any resource. The association between 
a RN and a resource is accomplished only by the context 
of the statements within the program using the RN. The 
RN is always known to the system but its meaning (the 
resource with which it is associated) is not. For this reason, 
all cooperating programs must agree on what RN is 
associated with what resource. 

Programs can lock more than one RN at a time. However, 
in doing so, the users must be careful to avoid the case 
where two suspended programs cannot be resumed because 
they are mutually blocked. 

EXECUTIVE COMMUNICATION 

When an executing program makes an EXEC call, it attempts 
to execute a jump subroutine (JSB) to that portion of the 
system located in the protected area of memory. This 
causes a memory protect violation interrupt which is duly 
processed by the system. The parameters associated with 
the EXEC call in the caUing program are examined. If the 
parameters are legal, the system processes the request. 
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Using EXEC calls, which are the line of communication 
between an executing program and RTE-IIl, a program is 
able to: 

Perform input and output operations 
Allocate and release disc space 
Terminate or suspend itself 
Load its segment (if background disc type) 

Schedule other programs 
Recover scheduling strings 
Obtain the time of day 

Set execution time cycles 

Obtain status information on partitions 

OPERATOR REQUESTS 

The operator retains ultimate control of the RTE-III system 
with requests entered through the teleprinter keyboard. 
(See Section II) Operator requests can interrupt RTE-III to: 

Turn programs on and off 

Suspend and restart programs 

Examine the status of any partition, program, or I/O 
device 

Schedule programs to execute at specified times 

Change the priority of programs 

Set up load-and-go operations and source files 

Declare I/O controllers or devices up or down 

Dynamically alter the logical I/O structure and buffer- 
ing designations 

EUminate disc-resident programs from the system 

Examine and dynamically alter an I/O device's time- 
out parameter 

Release tracks assigned to dormant programs 

Initialize the real-time clock and print the time 

SYSTEM CONFIGURATION 

User memory resident programs and disc resident programs, 
system programs, library routines, and Real-Time Executive 



Modules are incorporated into a configured RTE-III System. 
The RTE-III software is modular and of a general nature, so 
the user can configure his particular programs and I/O 
device drivers into a real time system tailored to his exact 
needs. 

Using the Real-Time Off-Line Generator (RTGEN), or the 
Real-Time On-Line Generator (RT3GN) and SWITCH, the 
relocatable software modules and user programs are con- 
verted into a configured real-time system in memory-image 
binary format stored on the system disc (LU2). In operation 
the configured system is loaded (bootstrapped) into the 
computer from the system area of the disc. The remaining 
disc storage is dynamically allocated by the configured 
system to user programs or is utilized by the scheduler for 
swapping operations. System configuration is detailed in 
Section VI of this manual and the On-Line Generator 
manual (92060-90016). 



SYSTEM/AUXILIARY DISCS 

The RTE-III System disc tracks are those for which RTE-III 
controls and maintains a track usage table. Programs may 
obtain and release tracks from this area using EXEC calls. 
System tracks include all tracks on the system subchannel 
(LU2) and the optional auxiliary subchannel (LU3). The 
system disc tracks are used for swapping, and by the editor, 
assembler, and compilers for source, load-and-go, and 
scratch area. They may also be used by user programs for 
storage. 



The main differences between a system disc and an 
auxiliary disc are: 

• The configured system (including the memory resi- 
dent system, the relocated disc resident programs, 
and the relocatable library), is stored on the system 
disc. 

• The auxiliary disc is optional. 

• Most program swapping takes place on the auxiliary 
disc. 



PERIPHERAL DISCS 

Peripheral discs (LU's greater than 6) are not managed by 
the RTE-III System but can be managed with the file man- 
ager program. Track allocation and usage in this case are 
totally up to the user through the file manager. Note that 
peripheral disc tracks may be protected the same as those 
on the system/auxiliary discs. 
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RTE-III SYSTEM SUMMARY 

The Hewlett-Packard Real-Time Executive-lII Software 
System is a multiprogramming, multi-partitioned system 
with priority scheduling interrupt handling, and program 
load-and-go capabilities. 

With multiprogramming, a number of data acquisition sys- 
tems or test stands can be operated simultaneously on a 
24-hour a day basis. Data reduction and report preparation 
functions can be scheduled to execute in the background 
area during times when real-time activities permit. The same 
computer can also be used by the programming group for 
ongoing development work with RTE-III's background 
compilers for FORTRAN, FORTRAN IV, and ALGOL, and 
with the HP Assembler, Editor, and other auxiharies. Pro- 
grams can be added to the system on-line, and on a load- 
and-go basis (no intervening paper tapes). For system pro- 
tection new programs can be debugged v/hile the memory 
protect fence maintains the integrity of the system area and 
the Dynamic Mapping System maintains the integrity of 
other user programs. 



The system controls I/O processing through a central rou- 
tine that directs requests and interrupts to the appropriate 
device driver subroutine. For efficiency, programs awaiting 
1/0 are suspended to let other programs use the computer. 
Outputs to slow devices can be buffered. For processes that 
cannot tolerate ordinary system overhead, a privileged 
interrupt option lets a device contact its driver directly 
without going through the Executive. 

The operator retains ultimate control of the RTE-III System 
with requests entered through the system console. The 
operator can turn programs on, make status checks, or 
perform other operations. 

Configuration is efficient. System generation may be done 
off-line or on-line using interactive operator dialog or pre- 
built answer files. This results in an operating system 
configured for a specific hardware system. 



Scheduhng of all programs is based on priority. External 
events can interrupt to schedule programs for execution, or 
a program can be scheduled by an operator request, a pro- 
gram request, or on a real-time clock basis .^ Priorities are 
assigned by the user during generation or on-line loading, 
and may be changed by an operator request. 
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SECTION II 
OPERATOR REQUESTS 



INTRODUCTION 

The operator controls an executing Real-Time Executive-Ill 
System by operator requests entered through the console. 
These operator requests can interrupt RTE to perform the 
functions described in Table 2-1. 

COMMAND STRUCTURE 

The operator gains the attention of RTE by pressing any 
key on the console. When RTE responds with an asterisk 
(*), the operator types any operator request (or command), 
consisting of a two-character request word (e.g., ON, UP, 
etc.) and the appropriate parameters separated by commas. 
Each command is parsed, or resolved, by a central routine 
that accepts certain conventions. Command syntax is 
described in Table 2-2 and, with the conventions described 
next, must be followed exactly to satisfy system require- 
ments. 



COMMAND CONVENTIONS 

• When the data is entered, the items outside the 
brackets are required symbols, and the items inside 
the brackets are optional. Note that when RTE-III is 
restarted, any parameters previously changed are 
restored to their original value set during RTGEN. 

• If an error is made in entering the parameters, 
CONTROL and A struck simultaneously will delete 
the last character entered if input is a teletype. If the 
system input device is a CRT terminal, the last 
character can be deleted with the backspace key. To 
delete the entire line use RUBOUT. Note that line 
feed is supplied by the system. Each request must be 
completed with an end-of-record terminator (e.g., 
carriage return for the teleprinter and CRT). 

• Two commas in a row mean a parameter is zero. 



Table 2-1 . RTE-III Operator Commands 



Command 
Format 


Description 


AB 


Abort current batch program. 


BL 


Sets buffer limits. 


BR 


Sets a break flag in named program's 




ID segment. 


DN 


Declare I/O controller or device unavailable. 


EQ 


Examine the status of any I/O device. 




and dynamically alter device buffering 




assignments. 


PL 


Buffer flush command used in conjunction 




with Multiple Terminal Monitor (MTM) only. 


GO 


Restart programs out of suspension. 


IT 


Sets time intervals for programs 


LG 


Allocate load-and-go area. 


LS 


SEt logical source pointer. 


LU 


Dynamically alter device logical unit 




assignments. 


OF 


Turn programs off. 


ON 


Turn programs on. 


PR 


Change the priority of programs. 


RU 


Start a program immediately. 


RT 


Release program's disc tracks. 


ss 


Suspend programs. 
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Table 2-1 . RTE-III Operator Commands (Continued) 



AB 



Command 
Format 


Description 


ST 


Examine the status of programs. 


TI 


Print the current time. 


TM 


Set the real-time clock. 


TO 


Examine and dynamically alter an I/O 




device's time-out parameter. 


UP 


Declare I/O controller and associated devices 




available. 



Table 2-2. Conventions in Operator Command Syntax 



Item 


Meaning 


UPPER CASE 
ITALICS 


These words are literals and 
must be specified as shown. 


lower case italics 


These are symbolic representa- 
tions indicating what type of 
information is to be supplied. 
When used in text, the italics 
distinguishes them from other 
textual words. 


[Mem] 


Items with brackets are optional. 
However, if item is not supplied, 
its position must be accounted 
for with a comma; this causes 
item to automatically default. 




Jteml 
,item2 
Jtem3 




This indicates that exactly one 
item may be specified. 


item 1 
item 2 
item 3 


This indicates that there is a 
choice of entries for the param- 
eter, but one parameter must be 
specified. 


... (row of dots) 


This notation means "and so 
on." 



Purpose: 

To abort the current File Manager Program running 
under batch. 

Format 



AB 



p] 



Where: 




terminates and removes from the time list 
the current BATCH program that is 
executing, scheduled, or operator sus- 
pended. Terminates BATCH programs 
which are I/O, memory, or disc suspended 
the next time they are scheduled. Disc 
tracks are not released. 

terminates immediately the BATCH pro- 
gram and removes it from the time list, and 
releases all disc tracks. If suspended for 
I/O, a system generated clear request is 
issued to the driver. 



COMMENTS 

When the File Manager is waiting on a program it is running 
(e.g., ASMB), the AB command aborts that program just 
like the 

OF, name command. 

If the File Manager is dormant, or non-existent in the 
system, the AB command will cause the error message 
ILLEGAL STATUS to be printed. If the File Manager is 
not dormant and is not running a program, this command is 
the same as 

BR,FMGR 
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BL 



BR 



Purpose: 








To examine or modify current Buffer Limits. 




Format: 








BL 


[lower limit, upper limit, ] 




Where: 








BL 




alone displays upper and lower 
limits previously set. 




lower limit 




is the lower limit number. 




upper limit 




is the upper limit number. 





COMMENTS 

Setting upper and lower memory limits with this command 
can prevent an inoperative or slow I/O device from 
monopolizing available system memory. Each time a 
buffered I/O request is made (Class I/O requests are 
buffered), the system adds up all the buffered words in I/O 
requests queued to that EQT entry and compares the 
number to the upper Hmit set by this command (or during 
generation). If the sura is less than the upper lirait the new 
buffered request is added to the queue. If the sum is larger 
than the upper limit the requesting program is suspended in 
the general wait (STATUS = 3) list. When a buffered I/O 
request completes, the system adds up the remaining words 
in I/O requests queued to that EQT entry and compares the 
number to the lower Umit set by this command (or during 
generation). When the sum is less than the lower limit, any 
programs suspended for exceeding the buffer limits on this 
EQT are rescheduled. 

Any program with a priority of 1 through 40 will not be 
suspended for buffer limit so alarm messages, etc., are not 
inhibited. 



Purpose: 










To set an 


attention flag in a program's 


ID 


segment. 


Format: 


BR, 


name 






Where: 










name is 


the name of the 


program. 







COMMENTS 

The BR command allows an operator to interrupt a 
program while it is running. When the BR command is 
executed, RTE sets bit 12 in word 21 of the named 
program's ID segment. The user's program can call an HP 
furnished subfunction that will test this bit and then act 
accordingly. The calling sequence of the subfunction is: 

I = IFBRK (DM) 

where DM is a dummy parameter to make the call appear as 
a function (DM need not be supplied in Assembly Language 
or ALGOL calls). The returned value will be negative if the 
break flag is set and positive if it is not. If the flag is set it 
will be cleared by IFBRK. 

DN 



Purpose: 

To declare an I/O controller or device down (i.e., 
unavailable for use by the RTE-III System). 



Format: 

Where: 
eqt 



DN 



,eqt 
„lu 



is the EQT entry number of the I/O controller 
to be set down. 



lu is the LU entry number oftiie I/O device to be 

set down. 
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COMMENTS 

Setting an I/O controller (EQT) down effectively sets all 
devices connected to the I/O channel down by blocking 
any I/O operations on the channel. The state of the devices 
(LU's) associated with the channel are unchanged. 

Setting the I/O device (LU) down will make only the 
specific device unavailable. However, all other LU's 
pointing to the device will also be set down. Other devices 
using this device's I/O channel are unaffected. 

The I/O controller or I/O device is left unavailable until the 
I/O controller is set up by the UP command. The operator 
might set a device down because of equipment problems, 
tape change, etc. 



EQ (status) 



Purpose: 

To print the description and status of an I/O controller, 
as recorded in the EQT entry. 



Format: 



Where: 



EQ, eqt 



eqt is the EQT entry number of the I/O controller. 



COMMENTS 

The status information is printed as: 

select code DVRnn D B IJnn status 
Where : 

select code is the I/O channel. 
DVRnn is the driver routine. 
D is D if DMA required, if not, 



B 



Unn 



is B if automatic output buffering used, if 
not, 

is the last subchannel addressed 



status is the logical status: 

- available 

1 - unavailable (down) 

2 - unavailable (busy) 

3 - waiting for DMA assignment 

Note that if eqt is it is a bit bucket, and the LU associated 
with it is also a bit bucket. 

This command is implemented by the disc resident pro- 
gram $$CMD. If $$CMD is not included in the operating 
system, the message NO SUCH PROG will be printed 
when the command is entered. 



EQ (buffering) 



Purpose: 

To change the automatic output buffering designa- 
tion for a particular I/O controller. 



Format: 

Where : 
eqt 



EQ,eqt 



UNbuffer 
,BUffer 



is the EQT entry number of the I/O 
controller. 



UNbuffer deletes buffering. 
Buffer specifies buffering. 

COMMENTS 



When the system is restarted from the disc, buffering 
designations made by the EQ command are reset to the 
values originally made during generation. 
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FL 



Purpose: 






To eliminate buffered output to an 


I/O 


device. 


Format: 






/w>FL 






Where: 






lu is the logical unit number of 


the inter- 


rupting terminal. 







COMMENTS 

The FLush command can only be used in conjunction with 
the Multiple Terminal Monitor (MTM), and can only be 
entered from a terminal other than the system terminal. 

Other methods of clearing the buffer are using an EXEC 
call or a File Manager command as follows: 

CALLEXEC(3,23/w) 

*ON,FMGR 

:CN,/M,23B 

GO 



Purpose: 

To reschedule a program that has been suspended by 
an SS command or a Suspend EXEC Call. 



Format: 



Where: 



name 



pi ... p5 



GO, 
GOIH, 



,name [,pi [, . . . [,p5] ]]]] 



is the name of a suspended program to be 
scheduled for execution. 

is a list of parameters to be passed to 
name only when name has suspended 
itself (see Suspend EXEC Call in Section 
III). The parameters are not required if 
name was suspended with the SS 
command. 



COMMENTS 

If the program has not been suspended previously by the 
operator or has not suspended itself, the request is illegal. 

Parameters pi through p5 can be entered in ASCII or 
numeric form. Octal numbers are designated by the "B" 
suffix and negative numbers by a leading minus sign. For 
example: 

GO,name,FI,LE,31061B 

Note that only two ASCII characters per parameter are 
accepted; if one is given, the second character is passed as a 
blank (blank = 40B). If the first parameter is ASCII 
"NO" then it must be repeated (the system interprets it as 
"NOW" in the GO command). For example: 

GO,name,NO,NO,FI,3,4,5 

is interpreted as shown below. NO (NOW) is not used 
except to push the parameters out. 

NO 
FI 

3 
4 

5 

After a program has suspended itself and is restarted with 
the GO command, the address of the parameters passed by 
GO is in the B-Register. InJEQKG^AN, an immediate call 
to the library subroutine(^MPAR_r)trieves the parameters 
(see Section III, Suspend EXEC Call). If the program has 
not suspended itself, the B-Register is restored to its value 
before suspension and the parameters are ignored. 

The program may also recover the ASCII command string 
(up to 80 characters typed after the prompt) that scheduled 
it by using the String Passage EXEC call (see Section III). 
If the program was rescheduled with a GOIH (inhibit string 
passage) or if the program has not suspended itself, the 
command string is not passed. 
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IT 



LG 



Purpose 




To set time values for a program, so that the program 


executes automatically at selected times when turned 


on with the ON command. 


Format 




\T,name [,res,>npt[ hr,min {,sec[,ms] ] ] ] 


Where: 




name 


is the name of the program. 


res 


is the resolution code 




1 - tens of milliseconds 




2 — seconds 




3 - minutes 




4 - hours 


mpt 


is a number from to 4095 which is used 




with res to give the actual time interval for 




scheduling (see Comments). 


hr 


hours 




min 
sec 


minutes 
seconds 


sets an initial start time. 


ms 


tens of ms. 





COMMENTS 

The resolution code {res) is the units in time to be 
multiplied by the multiple execution interval value {fnpt) to 
get the total time interval. Thus, [{ res=2 and m/;r=100, 
name would be scheduled every 100 seconds. U hr,min,sec 
and ms are present, the first execution occurs at the initial 
start time which these parameters specify. (Program must 
be initialized with ON command.) If the parameters are not 
present (e.g., IT, name), the program's time values are set to 
zero and the program is removed from the time list. The 
program can still be called by another program or started 
with the ON', name, N0\^ or RU command. 



Purpose: 










To allocate or release a group of disc 


tracks 


for 


load-and-go 


operations. 






Format: 




LG,numb 






Where: 










numb = 


(zero) 
area. 


releases the allocated 


load-and 


-go 


numb > 


release 


currently allocated 


oad-and 


-go 




tracks 


and then allocate numb 


contiguous 




tracks 


for a load-and-go area. 







COMMENTS 

The user must allocate enough tracks for storing binary 
object code before each load-and-go compilation or assem- 
bly. If not, the compiler or assembler aborts and a 
diagnostic is printed on the system console. 

IO06" Load-and-go area not defined. 

1009— Overflow of load-and-go area. 

An LG request should not be used while a compiler or the 
Assembler is using the load-and-go tracks. If done, this may 
result in the message 

LGO IN USE 

being printed on the system console, and no change in the 
current number of load-and-go tracks. In most cases, 
however, it results in an IO06 error. 



When the system is restarted from the disc, time values set 
by the IT command are lost, and the original time values set 
at original load time are reinstated. 

The IT command is similar to the Execution Time EXEC 
Call (See Section III). 
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LS 



LU # 7 = E12 S 1 D 



Purpose: 




To designate 


the disc logical unit number and starting 


track number of an existing source file before | 


operating on 


it with EDITR, FTN, FTN4, ALGOL, 


ASMB. 




Format: 






LS>,disc lu, trk numb 


Where: 




disc lu 


is the logical unit number of the disc 




containing the source file. 




2 or 3 = system or auxiliary disc units. 




= eliminate the current source 




file designation. 


trk numb 


is the starting track number of the 




source file (in decimal). 



COMMENTS 

LS replaces any previous file declarations with current file. 
Only one file may be declared at a time. 

For details on creating, updating, compiUng, or assembling 
source files, see Section IV, Background Programming. 



LU (assignment) 



Purpose: 


To print the EQT (channel) number and device sub- 
channel number and I/O device status associated with 
a logical unit number. 


Format: 


U],lu 


Where: 


lu is a logical unit number from 1 to 63. 



logical unit number 



EQT (controller) number 
subchannel number 



I/O device status 



If the logical unit is disabled (down) then a D is printed as 
the status; otherwise the position is left blank. 

This command is implemented by the disc resident pro- 
gram $$CMD. If $$CMD is not included in the operating 
system, the message NO SUCH PROG will be printed when 
the command is entered. 



LU (reassignment) 



Purpose: 




To change a 


logical unit number assignment. 


Format: 






LVJu'q^^ Isubch numb] 


Where: 




lu 


is a logical unit number from 1 to 63 




(decimal). 


eqt 


is an EQT entry number to assign 




lu. 


eqt 


if zero (0) lu becomes the bit bucket. 


subch numb 


is a subchannel number (0 to 3 1) to 




assign to lu. 



COMMENTS 

The LU command can be used to change subchannel bits of 
DVROO in reference to an EOT setting the tape reader 
down. Refer to the Multiple Device Driver DVROO manual 
HPPart No. 29029-95001. 

The restrictions on changing logical unit assignments are: 

a. LUl (system console) must be a keyboard en- 
try device (e.g., teleprinter). Note that if LUl is 
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changed from one keyboard device to another, the 
new device will print a double asterisk (**). 

b. LU2 (system disc) and LU3 (auxiliary disc) can- 
not be changed to another EQT entry number. 

c. An LU cannot be changed to point at the same 
device as LU2 or LU3. 

When an irrecoverable problem occurs on an 1/0 device, the 
operator can bypass the downed device for future requests 
by reassigning the logical unit number to an operable device 
on another channel. Any programs referencing the downed 
device are suspended until the device is declared UP. 

When the system is restarted from the disc, any assignments 
made by LU are reset to those originally set during 
generation. 

Section V, Real-Time Input/Output, explains logical unit 
numbers, equipment table entry numbers, and subchannel 
numbers in detail. 

This command is implemented by the disc resident pro- 
gram $$CMD. If $$CMD is not included in the operating 
system, the message NO SUCH PROG will be printed when 
the command is entered. 



OF 



Purpose: 

To terminate a program, or to remove a disc resident 
program which was loaded on-line but not permanently 
incorporated into the protected RTE-III system. 



Format: 



OF, name 



,0 



Where: 

name is the name of the program. 

terminates and removes from the time list 
the named program the next time it is 
scheduled. The program's disc tracks are not 
released. 

1 terminates immediately the named program, 
removes it from the time list, and releases all 
disc tracks. If suspended for I/O, a system 
generated clear request is issued to driver. 



terminates immediately the named program, 
and if the program is a temporary program 
loaded on-line, it is permanently removed 
from the system. 



COMMENTS 

For programs with segments, the OF, name, 8 command 
must be used on the segments as well as the main. 

0¥,name,^ will not remove permanent programs because 
their ID segments on the disc are not altered by this re- 
quest. A permanent program is defined as a program loaded 
during generation, or on-Hne with the LOADR and with a 
copy of its ID segment in core and on the disc. For tem- 
porary programs loaded on-line the ID segment is blanked 
making the segment available for loading another program 
with LOADR. The tracks (if they are system tracks) con- 
taining the program are released. If the program had been 
stored on File Manager tracks, those tracks are not returned 
to the system but remain as File Manager tracks. 

If the program is I/O suspended, a system generated clear 
request is issued to the driver. The 0F,name,8 command 
must then be entered a second time to permanently re- 
move name from the system in this case. 

A permanent disc resident program is removed with the 
LOADR as described in Part 5 of Section IV. 



ON 



Purpose: 

To schedule a program for execution. Up to five param- 
eters and the command string may be passed to the 
program. 

Format: 

ON 



ONIH ^^^^^l^OW] lpl[,...lp5]m] 



Where: 



name 



NOW 



is the name of a program. 

schedules a program immediately that is 
normally scheduled by the system clock 
(see IT). 



pi ... p5 are parameters passed to the. program 
when it is scheduled. 
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COMMENTS 



PR 



Parameters pi through p5 are the ones passed l(y RMPAR 
as described under Comments in the Prograni Scliedule 
EXEC Call in Section III. Refer also to XTEMP words 
2 through 6 in the program's ID segment (see Appendix 
A). Note that any parameters not entered as part of 
the ON command will be returned as zeros by a call to 
RMPAR. 

Parameters pi through p5 can be entered in ASCII or nu- 
meric form. Octal numbers are designated by the "B" suffix 
and negative numbers by a leading minus sign. For 
example: 

ON,name,FI,LE,31061B 

Note that only two ASCII characters per parameter are 
accepted; if only one is given, the second character is passed 
as a blank, (blank = 40 B). If the first parameter is ASCII 
"NO" then it must be repeated (the system interprets it as 
"NOW" in the ON command). For example: 

ON,name,NO,NO,FL3,4,5 



^ 



Purpose: 








To chan 


le the 


priority of a 


program. 


Format: 












?R,name,numb 


Where: 








name 


is the 


name of the 


program. 


numb 


is the 


new priority 





COMMENTS 

One (1) is the highest priority, and 32767 is the lowest. 
When the system is restarted from the disc, the priority of 
name resets to the value set by the generator or LOADR. 



is interpreted as 



RU 



NO 
FI 

3 
4 

5 



The program can recover the ASCII command string (up to 
80 characters typed after the prompt) by using the String 
Passage EXEC call (see Section III). The ONIH command 
inhibits the passage of the command string. 

If the resolution code in the ID- segment of the program is 
not zero, RTE-III places the program in the time list for 
execution at specified times (unless NOW appears in which 
case, the program is scheduled and put into the time list 
immediately). The resolution code may be non-zero as a 
result of: 

a. Generation 



Purpose: 

To schedule a program immediately without affecting 
its entry in the time list. Up to five parameters and 
the command string may be passed to the program. 



Format: 



Where: 



name 



pi... p5 



RU 
RUIH 



,name[,pl [, . . . [,p5]]]]] 



is the name of a program. 

are parameters passed to the program 
when it is scheduled. 



1 . With a resolution code in the name record 

2. Entry of a resolution code during param- 
eter input phase. 

b. The IT command. 

c. Scheduhng the program with absolute start 
time or offset by some program in the system. 



COMMENTS 

The RU command is usually used when the operator desires 
to run a program without affecting its entry in the time list. 



Parameters pi through p5 are the ones passed ^y RMPAR 
as described under Comments in the Program* 
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EXEC Call in Section III. Refer also to XTEMP words 2 
through 6 in the program's ID segment (see Appendix A). 
Note that any parameters not entered as part of the RU 
command will be returned as zeros by a call to RMPAR. 

Parameters pi through p5 can be entered in ASCII or 
numeric form. Octal numbers are designated by the "B" 
suffix and negative numbers by a leading minus sign. For 
example: 

RU,name,FI,LE,31061B 

Note that only two ASCII characters per parameter are 
accepted; if only one is given, the second character is passed 
as a blank (blank = 40B). If the first parameter is ASCII 
"NO" then it must be repeated (the system interprets it as 
"NOW" in the RU command). For example: 

RU,name,NO,NO,FI,3,4,5 



is interpreted as shown below. NO(NOW) is not used except 
to push the parameters out. 



NO 
FI 

3 

4 
5 



The program can recover the ASCII command string (up to 
80 characters typed after the prompt) by using the String 
Passage EXEC call (see Section III). The RUIH command 
inhibits the passage of the command string. If there are no 
characters past name, the command string is not trans- 
mitted. 



RT 



COMMENTS 

If the program is not dormant, the command is illegal. 

If the program is dormant, all tracks assigned to that 
program are released. 

If any tracks are released as a result of this command, all 
programs in disc track allocation suspension are re- 
scheduled. 



ss 



Purpose: 

To suspend a non-dormant program. 

Format: 

SS,/7flwe 
Where: 
name is the name of the program to be suspended. 



COMMENTS 

The SS command places the program in the operator 
suspended list immediately if the program is executing or 
scheduled. If the program is dormant the request is illegal. 
If the program is suspended for I/O memory or disc, RTE-III 
waits until the current suspend is over, then suspends the 
program with SS. 

The SS command is similar to the Program Suspend EXEC 
Call (see Section III). 



Purpose 












To release all disc tracks assigned to 


a pre 


gram. 


Format: 
















Kl,name 






Where: 












name 


is the 
tracks 


name of the 
released. 


program 


that 


is to have its 
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ST 



Purpose: 

To request the status (priority, current list, time 
values) of a named program, or to determine the 
name and partition number of the program cur- 
rently occupying memory, or print the name of 
the program occupying a specified partition. 

Format (status of a program): 

ST, name 

Format (name and partition number of current 
program) : 

ST,6» 

Format (name of program in specified partition): 

ST part numb 

Where: 

name is the name of the program whose status is 
to be printed. 

causes the system to print the name and 

partition number of the program currently 
in memory. If none, then is printed. 

part is a partition number; causes the system to 

numb print the name of the program in part numb. 

If the partition is empty, is printed. If 

part numb is wrong, NO SUCH PROG is 

printed. 



COMMENTS 

The status of a program is printed on one line in a fixed 
format: 

pr s res mpt hr min sec ms T 



5— Disc allocation suspend 

6— Operator suspend or programmed suspend 
(EXEC 7 Call) 

9- Background segment. 

res, mpt, hr, min, sec and ms are all zero (0) unless 
the program is scheduled by the clock (see IT, this 
section, for the meaning of these items). 

The letter "T" appears when the program is currently in the 
time list (as the result of an ON command). 

A program is placed in the general wait list (status = 3) 
whenever: 

a. It is waiting for a Resource Number (RN) to 
clear or become available. This includes Logical Unit 
(LU) locks and attempts to use a locked LU. 

b. A schedule request is made with ICODE = 23 or 
24 (queue schedule), and the program being called is 
busy. 

c. A request is made to an I/O device that is 
down. This differs from a request to an I/O device 
that is busy. 

d. A Class I/O GET Call is made and the Class 
Queue is empty. 

e. A program is waiting for another program to 
complete as a result of an Exec 9 or 23 call. 

f. A program is waiting on a Buffer limit (see 
BL this section). 

Programs will be removed from the general wait list when 
the action waited for takes place, or when the program is 
aborted. 

When the format ST,0 is used, the status is printed as: 

name part numb 

Wliere 



name 



part 
numb 



is the name of the program currently residing 
in partition number part numb. 

is the partition number. 



When the format ST part numb is used, the status is printed 
as: 



Where 



name 



pr is the priority, a decimal value from 1 to 32161 . 

s is the current state of the program. 

0— Dormant 

1— Scheduled 

2— I/O suspend 

3— General wait 

4— Unavailable memory suspend 
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Table 2-3. Day of Year 



JANUARY 1 




1/2 


1/3 




1/4 




1/5 




1/6 




1/7 




( 2) 


( 3) 




( 4) 




( 5) 




( 6) 




( 7) 


1/8 


1/9 


1/10 




1/11 




1/12 




1/13 




1/14 


( 8) 


(9) 


(10) 




(11) 




(12) 




(13) 




(14) 


1/15 


1/16 


1/17 




1/18 




1/19 




1/20 




1/21 


(15) 


(16) 


(17) 




(18) 




(19) 




(20) 




(21) 


1/22 


1/23 


1/24 




1/25 




1/26 




1/27 




1/28 


(22) 


(23) 


(24) 




(25) 




(26) 




(27) 




(28) 


1/29 


1/30 


1/31 


















(29) 


(30) 


(31) 



















2/1 
(32) 

2/8 
(39) 

2/15 
(46) 

2/22 
(53) 

2/29 
(60) 



2/2 
(33) 

2/9 
(40) 

2/16 
(47) 

2/23 
(54) 



2/3 
(34) 

2/10 
(41) 

2/17 
(48) 

2/24 
(55) 



2/4 
(35) 

2/11 
(42) 

2/18 
(49) 

2/25 
(56) 



2/5 
(36) 

2/12 
(43) 

2/19 
(SO) 

2/26 
(57) 



2/6 
(37) 

2/13 
(44) 

2/20 
(51) 

2/27 
(58) 



2/7 
(38) 

2/14 
(45) 

2/21 
(52) 

2/28 
(59) 



LEAP YEAR ONLY 



3/1 
(60) 

3/8 
(67) 

3/15 
(74) 

3/22 
(81) 

3/29 
(88) 



3/2 
(61) 

3/9 
(68) 

3/16 
(75) 

3/23 
(82) 

3/30 
(89) 



3/3 
(62) 

3/10 
(69) 

3/17 
(76) 

3/24 
(83) 

3/31 
(90) 



3/4 
(63) 

3/il 
(70) 

3/18 
(77) 

3/25 
(84) 



3/5 
(54) 

3/12 
(71) 

3/19 
(78) 

3/26 
(85) 



3/6 
(65) 

3/13 
(72) 

3/20 
(79) 

3/27 
(86) 



3/7 
(66) 

3/14 
(73) 

3/21 
(80) 

3/28 
(87) 



4/8 
(98) 

4/15 
(105) 

4/22 
(112) 

4/29 
(119) 



4/2 

(92) 

4/9 

(99) 

4/16 
(106) 

4/23 
(113) 

4/30 
(120) 



4/3 
(93) 

4/10 
(100) 

4/17 
(107) 

4/24 
(114) 



4/4 
(94) 

4/11 
(101) 

4/18 
(108) 

4/25 
(115) 



4/5 
(95) 

4/12 
(102) 

4/19 
(109) 

4/26 
(116) 



4/6 
(96) 

4/13 
(103) 

4/20 
(110) 

4/27 
(117) 



4/7 
(97) 

4/14 
(104) 

4/21 
(111) 
4/28 
(118) 



MAY 1 


5/1 
(121) 


5/2 
(122) 


5/3 
(123) 




5/4 
(124) 


5/5 
(125) 


5/6 
(126) 


5/7 
(127) 


5/8 


5/9 


5/10 




5/11 


5/12 


5/13 


5/14 


(128) 


(129) 


(130) 




(1?1) 


(132) 


(133) 


(134) 


5/15 


5/16 


5/17 




5/18 


5/19 


5/20 


5/21 


(135) 


(136) 


(137) 




(138) 


(139) 


(140) 


(141) 


5/22 
(142) 


5/23 
(143) 


5/24 
(144) 




5/25 
(145) 


5/26 
(146) 


5/27 
(147) 


5/28 
(148) 


5/29 
(149) 


5/30 
(150) 


5/31 
(151) 













6/1 
(152) 



(159) 

6/15 
(166) 

6/22 
(173) 

6/29 
(180) 



6/2 
(153) 

6/9 
(160) 

6/16 
(167) 

6/23 
(174) 

6/30 
(181) 



6/3 
(154) 

6/10 
(161) 

6/17 
(168) 

6/24 
(175) 



6/4 
(155) 

6/11 
(162) 

6/18 
(169) 

6/25 
(176) 



6/5 
(156) 

6/12 
(163) 

6/19 
(170) 

6/26 
(177) 



(157) 



6/20 
(171) 

(b/27 
78) 



6/14 
(165) 

6/21 
(172) 



JULY 




AUGUST 




SEPTEMBER | 


7/1 
(182) 


7/2 
(183) 


7/3 
(184) 


7/4 
(185) 


7/5 
(186) 




7/6 
(187) 




7/T 
(188) 


8/1 
(213) 


8/2 
(214) 


8/3 
(215) 


8/4 
(216) 


8/5 
(217) 


8/6 
(218) 




8/7 
(219) 


9/1 
(244) 


9/2 
(245) 


9/3 
(246) 


9/4 
(247) 


9/5 
(248) 


9/6 
(249) 


9/7 
(250) 


7/8 
(189) 


7/9 
(190) 


7/10 
(191) 


7/11 
(192) 


7/12 
(193) 




7/13 
(194) 




7/14 
(195) 




8/8 
(220) 


8/9 
(221) 


8/10 
(222) 


8/11 
(223) 


8/12 
(224) 


8/13 
(225) 




8/14 
(226) 




9/8 
(251) 


9/9 
(252) 


9/10 
(253) 


9/11 
(254) 


9/12 
(255) 


9/13 
V2S6) 


9/14 
(257) 


7/15 
(196) 


7/16 
(197) 


7/17 
(198) 


7/18 
(199) 


7/19 
(200) 




7/20 
(201) 




7/21 
(202) 




8/15 
(227) 


8/16 
(228) 


8/17 
(229) 


8/18 
(230) 


8/19 
(231) 


8/20 
(232) 




8/21 
(233) 




9/15 
(258) 


9/16 
(259) 


9/17 
(260) 


9/18 
(261) 


9/19 
(262) 


'J/20 
(263) 


9/21 
(264) 


7/22 
(203) 


7/23 
(204) 


7/24 
(205) 


7/25 
(206) 


7/26 
(207) 




7/27 
(208) 




7/28 
(209) 




8/22 
(234) 


8/23 
(235) 


8/24 
(236) 


8/25 
(237) 


8/26 
(238) 


8/27 
(239) 




8/28 
(240) 




9/22 
(265) 


9/23 
(266) 


9/24 
(267) 


9/25 
(268) 


9/26 
(269) 


9/27 
(270) 


9/28 
(271) 


7/29 
(210) 


7/30 
(211) 


7/31 
(212) 
















8/29 
(241) 


8/30 
(242) 


8/31 
(243) 














9/29 
(272) 


9/30 
(273) 













lO/l 
(274) 

10/8 
(281) 
10/15 
(288) 
10/22 

(29S> 

iO/29 
(302) 



(275) 
10/9 
(282) 
10/16 
(289) 
10/23 
(296) 

10/30 
(303) 



10/3 
(276) 

10/10 
(283) 
10/17 
(290) 
10/24 
(297) 

10/31 
(304) 



10/4 
(277) 

10/11 
(284) 
10/18 
(291) 
10/25 
(298) 



10/5 
(278) 

10/12 
(285) 
10/19 
(292) 
10/26 
(299) 



10/6 
(279) 

10/13 
(286) 
10/20 
(293) 
10/27 
(300) 



10/7 
(280) 

10/14 
(287) 
10/21 
(294) 
10/28 
(301) 



NOVEMBER | 


11/1 
(305) 


11/2 
(306) 


11/3 
(307) 


11/4 
(308) 


11/5 
(309) 


11/6 
(310) 


11/7 
(311) 


11/8 
(312) 


11/9 
(313) 


11/10 
(314) 


11/11 
(315) 


11/12 
(316) 


11/13 
(317) 


11/14 
(318) 


11/15 
(319) 


11/16 
(320) 


11/17 
(321) 


11/18 
(322) 


11/19 
(323) 


11/20 
(324) 


11/21 
(325) 


11/22 
(326) 


11/23 
(327) 


11/24 
(328) 


11/25 
(329) 


11/26 
(330) 


11/27 
(331) 


11/28 
(332) 


11/29 
(333) 


11/30 
(334) 













DECEMBER | 


12/1 


12/2 


12/3 


12/4 


12/5 


12/6 


12/7 


(335) 


(336) 


(337) 


(338) 


(339) 


<340) 


(341) 


12/8 


12/9 


12/10 


12/11 


12/12 


12/13 


12/14 


(342) 


(343) 


(344) 


(345) 


(345) 


(347) 


(348) 


12/15 


12/15 


12/17 


12/18 


12/19 


12/20 


12/21 


(349) 


(350) 


(351) 


(352) 


(353) 


(354) 


(355) 


12/22 


12/23 


12/24 


12/25 


12/26 


2/27 


12/28 


(356) 


(357) 


(358) 


(359) 


(360) 


(361) 


(362) 


12/29 


12/30 


12/31 










(363) 


(364) 


(355) 











Note: For leap year, add one to each number starting at 3/1 (60). 
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Tl 



Purpose: 

To print the current year, day and time, as recorded 
in the real-time clock. 



Format: 



TI 



COMMENTS 

The computer prints out the year, day and time: 
YEAR DAY HR MIN SEC 



Where 
YEAR 
DAY 



is the four-digit year. 

is the three-digit day of the year (see 
Table 2-3 for day of year conversion). 



HR,MIN,SEC is the time on a 24-hour clock. 

The TI command is similar to the Time Request EXEC Call! 
(see Section III). 



TM 



Purpose: 




To set the i 


■eal-time clock. 


Format: 






TM,year,day [,hr,min,sec] 


Where: 




year 


is a four-digit year. 


day 


is a three-digit day of the year (see 




Table 2-3). 


hr,min,sec 


is the current time of a 24-hour clock. 



COMMENTS 

The operator should give TM in response to the message 
printed when the RTE-III System is initiated from the disc: 



SET TIME 

The response sets the time when the return key is pressed. 
Enter a time value ahead of real-time. When real-time equals 
the entered value, press carriage return. The system is now 
synchronized with the time of day. 

NOTE 

The real-time clock is automatically 
started from 8:00 on the approx- 
imate system release date each time 
the system is loaded into core. 



TO 



Purpose 




To print 


or change the time-out parameter of an I/O 


device. 




Format: 






TO,eqt[,numb\ 


Where: 




eqt 


is the EQT entry number of the I/O device. 


numb 


is the number of 10 ms intervals to be used 




as the time-out value, {numb cannot be less 




than 500 (5 sec) for the system input 




device driven by DVROO/05). 



COMMENTS 

The time-out value is calculated using numb time-base 
generator interrupts (the time-base generator interrupts 
once every 10 ms). For example, numb = 100 sets a 
time-out value of one second: 100 • 10 ms = 1 second. 
When the system is restarted from the disc, time-out values 
set by TO are reset to the values originally set during 
RTGEN. 

If numb is absent the time-out value of eqt is printed. The 
information is printed as: 

TO #3 = 100 

and means EQT entry number 3 has a time-out value of 100 
ten miUisecond intervals or one second. 
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If a device has been initiated, and it does not interrupt 
within the interval set by the time-out parameter, the 
foUov^ing events take place: 

a. The calling program is rescheduled, and a zero 
transmission log is returned to it. 



The UP command places all downed devices (LU's) and the 
I/O controller (EQT) in the available state. Any I/O opera- 
tions associated with downed devices are queued on the 
EQT for processing. If a device's problem has not been 
corrected, it will be reset down and an error message will 
be printed: 



b. The device is set to the down status, and bit 1 1 
in the fourth word of the device's EQT entry is set to 
one. An error message is printed; e.g., 

I/O TO L #>: E #y S #z 

c. The system issues a CLC to the device's I/O 
select code(s) through the EQT number located in the 
interrupt table. 

This command is implemented by the disc resident pro- 
gram $$CMD. If $$CMD is not included in the operating 
system, the message NO SUCH PROG will be printed when 
the command is entered. 



I/O NRE #x L #y S #z 

SYSTEM COMMAND PROGRAM ($$CMD) 

A foreground disc resident program, $$CMD, implements 
the EQ, LU, and TO system commands. If $$CMD does 
not exist in the system, the message NO SUCH PROG is 
printed when the commands are entered. 

If the disc is down, the commands are unavailable. This 
situation can be avoided by making $$CMD memory 
resident during system generation. 



UP 



ERROR MESSAGES 



Purpose: 

The declare an I/O controller and all associated devices 
up (i.e., available for use by the RTE-III System). 



Format: 

Where: 
eqt 



V}?,eqt 



is the EQT entry number of the I/O controller 
to be re-enabled. 



COMMENTS 

When the operator of the RTE-III System has set an I/O 
controller or device down for some reason, the operator 
should correct the situation before declaring the item 
available again with the UP command. If the problem is 
irrecoverable, the operator can use LU to switch the 
logical unit number assignment to another device for 
further requests (see LU, this section). Previous requests 
made to this device are switched to the new device. To 
prevent indefinite I/O suspension on a downed device, 
time-out is used. Refer to I/O Device Time-Out in Section V, 
and the TO command in this section. 



RTE-III rejects operator requests for various reasons. When 
a request is in error, RTE-III prints one of the messages 
below. The operator should re-enter, the request correctly. 



Message 
OP CODE ERROR 
NO SUCH PROG 

INPUT ERROR 



Meaning 

Illegal operator request word. 

The name given is not a main 
program in the system. 

A parameter is illegal. 



ILLEGAL STATUS Program is not in appropriate state. 



CMD IGNORED- 
NOMEM 



Not enough system available mem- 
ory exists for storing the program's 
command string. Re-enter the 
command (RU, ON, GO) or enter 
the inhibit (IH) form of the 
command. 



Other errors may occur when an 1/0 device times out 
because of an inoperable state. When this occurs the 
operator can use the LU operator command to change the 
referenced device to another that works. 
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For example, the line printer may be in the OFF-LINE 
condition (or the operator has failed to engage the paper 
tape reader clutch). In this case the system will print one of 
the following error messages and suspend the program. 



Another example is that the program may be in the process 
of printing a long listing on the line printer when the 
printer runs out of paper. In this case it is possible to switch 
LU's and continue the listing without interruption as shown 
below. 



I/ONR L #lu E #eqt S #sub 
I/O TO L #lu E #eqt S #sub 



I/O TO L #lu E #eqt S #sub 
L\J, lu,eqt 



After the operator has corrected the device problem, all 
that is required is to type: 

\]?,eqt 

where eqt is the downed device's equipment table entry 
number (same number given in the I/O error message). The 
program is automatically rescheduled and the desired I/O 
operation takes place. 



The error message says that the device at LU number lu , 
EQT number eqt, subchannel number sub has timed out 
and has been set down by the system. Note that some 
drivers handle time out themselves and do not cause the 
specified actions. In this case the error message states that 
the device is not ready (NR). The operator switches logical 
units (with the LU command). The listing will continue on 
the new device. 
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SECTION III 
EXEC CALLS 



INTRODUCTION 

This section describes the basic formats of FORTRAN, 
FORTRAN IV, ALGOL, and Assembly Language EXEC 
Calls with each call presented in detail. Table 3-1 is a 
summary of the EXEC calls Hsted in the order of 
appearance in this section. The error messages associated 
with the calls are listed at the end of this section. Refer to 
Appendix D at the rear of this manual for a summary of the 
EXEC calls and required parameters. 

An EXEC call is a block of words consisting of a "J SB 
EXEC" instruction and a list of parameters defining the 
request. The execution of the "JSB EXEC" instructions 
causes a memory protect violation interrupt and transfers 
control into the EXEC module. EXEC then determines the 
type of request (from the parameter Hst) and, if it is legally 
specified, initiates processing of the request. 

In FORTRAN and FORTRAN IV, EXEC calls are coded as 
CALL statements. In ALGOL, EXEC calls must be declared 
as CODE procedures and parameters must be declared as 
NAME. In Assembly Language, EXEC calls are coded as 
JSB EXEC followed by a series of parameter definitions. 
For any particular call, the object code generated for the 
FORTRAN CALL Statement is equivalent to the 
corresponding Assembly Language object code. 

ERROR RETURN POINT 

The user can alter the error return point of EXEC calls in 
association with error codes LU, SC, 10, DR, and RN as 
shown in the following example. 



The special error return will also return control to the 
calling program on a disc parity error on the system disc. 
In this case the B-Register will be set to - 1 instead of the 
transmission log and the return will be to the normal 
return point. If there is an error the A-Register will be set 
to the ASCII error type (LU,SC,LO,DR,RN) and the 
B-Register set to the ASCII error numbers normally 
printed on the system console. 

The following excerpts from an example program 

demonstrates the use of the special error return. 

FTN,L 

PROGRAM PROGA 

DIMENSION IREG(2) 

EnUIVALENCE (REG, IREG, lA) , (IREG (2) , IB) 



When an EXEC call is issued, the sign bit must be set in the 
request code. 

CALL EXEC (ICODK-I-100000B, . . . ) 
GO TO 10 (ERROR RETURTJ POINT) 

: (NO ERROR RETURN POINT) 

After the following hne of code is executed, "lA" will 
contain the A-Register contents and "IB" the B-Register 
contents. Note the EQUIVALENCE statement at the 
beginning of the example. 

10 CALL ABREG (I A, IB) 

Next call the user defined error routine and pass it the error 

code. 

CALL IER(IA,IB) 



CALL EXEC (ICODE . . , 
GO TO error routine 
normal return 



END 



This special error return is established by setting bit 1 5 to 
"1" on the request code word (ICODE). This causes the 
system to execute the first line of code following the CALL 
EXEC if there is an error, or if there is no error, the second 
line of code following the CALL EXEC. 
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Table 3-1. RTE-III EXEC Calls 



Call 


Request 
Code 


Function 


Page 


READ,WR1TE 


1,2 


Transfers information to and from an external I/O 
device. 


3-4 


Class 1/0 READ,WR1TE 
WRITE/READ 


17,18,20 


Starts a no-wait I/O request which results in a transfer 
of information to and from an external I/O device 
or program. 


3-6 


1/0 Control 


3 


Instigates various 1/0 control operations. 


3-10 


Class 1/0 Control 


19 


Instigates various I/O control operations under Class 
numbering scheme. 


3-12 


Class 1/0 Get 


21 


Completes the data transfer initiated by 'the Class I/O 
request. 


3-13 


1/0 Status 


13 


Requests information about a device. 


3-15 


Disc Track Allocation 
Program 
Global 


4 
15 


Assigns a specific number of disc tracks for data storage. 


3-18 


Disc Track Release 
Program 
Global 


5 
16 


Release assigned disc tracks 


3-19/3-20 


Program Completion 


6 


Logically terminates execution of a calling program. 


3-21 


Program Suspend 


7 


Suspends calling program execution. 


3-22 


Program Segment Load 


8 


Loads a program segment into background area. 


3-23 


Program Schedule 


9 
10 

23 
24 


Schedules a program for execution. 
Immediate with wait. 
Immediate without wait. 
Queue with wait. 
Queue without wait. 


3-24 


Time Request 


11 


Requests current real time. 


3-26 


String Passage 


14 


Retrieves program's command string or passes string 
to program's "Father." 


3-27 


Timed Execution 
Initial Offset 
Absolute Start 


12 
12 


Schedules a program for execution after an initial offset. 
Schedules a program for execution at a specified time. 


3-29 
3-31 


Program Swapping 
Control 


22 


Allows a program to lock itself into core and notify 
system of core usage. 


3-33 


Resource Management 




Allows cooperating programs a method of efficiently 
utilizing resources. 


3-34 


Logical Unit Lock 

Partition Status 


25 


Allows a program to exclusively dominate an I/O device. 

Provides information about a specified partition. 


3-36 

3-37 
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The Relocatable Library routme^ ABREG,i/used to pick up 
information left in the A- and B-Registers by EXEC. The 
ALGOL format is: 

INTEGER IA,IB; 



PROCEDURE ABREG(A,B); 
INTEGER A,B; 

CODE ; 
ABREG(IA,IB) ; 

ASSEMBLY LANGUAGE FORMAT 

The following is a general model of an EXEC call in 
Assembly Language: 



EXT 

JSB 
DEF 



EXEC 
EXEC 



DEF 



Pl 



DEF 
return 



pn 
point 



Used to link 
program to RTE-III. 

Transfer control to 
RTE-III. 

Defines point of 
return from RTE-III; 
n is number of 
parameters and may 
not be an indirect 
address. 

Define addresses of 
parameters which may 
occur anywhere in 
program; may be multi- 
level indirect. 

Continue execution of 
program. 



pl 



pn 



Actual parameter values, 



FORTRAN/FORTRAN IV FORMAT 

In FORTRAN and FORTRAN IV, the executive can be 
called through a CALL statement or as a function. The 
function is used when the user wants the A- and B-Registers 
returned in a variable. 



For example, as a CALL: 
CALL EXEC (ICODE, p2, 



,pn) 



Where 

ICODE andp2 through p« are either integer values or 

integer variables defined else- 
where in the program. 

For example, as a function: 

DIMENSION IREG(2) 

EQUIVALENCE (REG, IREG, lA) , (IREG(2) ,IB) 

REG=EXEC ( ICODE, p2. . .,pn) 

The A-Register is returned in lA and the B-Register in IB. 

ALGOL FORMAT 

In ALGOL, the EXEC routine must be declared as an 
external CODE procedure before it is used. All formal 
parameters should be integers. Parameters that are not 
buffers and those that will not be modified by EXEC can 
be passed by value. When calling EXEC from ALGOL, 
pass a buffer by specifying the first element in an integer 
array (not the array name) as the actual parameter. For 
example, the following ALGOL program uses the EXEC 
routine with four parameters to perform a read: 

HPAL,L,"MAIN" 

INTEGER ICNWD; 

INTEGER ARRAY IBUFR[20]; 

PROCEDURE EXEC(A,B,C,D) ; 

VALUE A, D; INTEGER A,B,C,D; 

CODE ; 

EXEC (1, ICNWD, IBUFR[1] ,20) ; 

END$ 

The EXEC routine can be called with 1 to 9 parameters. 
However, ALGOL requires procedures to be caUed with a 
fixed number of parameters. If an ALGOL program calls 
EXEC with different numbers of parameters, unique 
procedure names must be declared within the main pro- 
gram and an external procedure must be written for each 
unique call. In the following example, a second EXEC call 
has been added to get the system time: 

HPAL,L,"MAIN" 

INTEGER ICNWD? 

INTEGER ARRAY IBUFR[20], ITIME[5]; 

PROCEDURE EXEC(A,B,C,D) ; 

VALUE A,D; INTEGER A,B,C,D; 
CODE ; 



3-3 



RTE-III 

PROCEDURE EXECA(A,B)' 
VALUE A: INTEGER A^B; 
CODE ; 

EXEC(1,ICNWD,IBUFR[1] ,20) ; 

EXECA(11,TIME[1] ) ; 

END? 
(External) 

The following external procedure would be compiled 
separately: 



HPAL,L,P,"EXECA" 
PROCEDURE EXECA(A,B); 

VALUE A; INTEGER A,B; 
BEGIN 
PROCEDURE EXEC (A, B); 

INTEGER A,B; 

CODE ; 
EXEC (A, B) ; 
END; 



READ/WRITE 



Purpose: 








To transfer information to or from an I/O device. 


For a READ request, or, if the I/O device is not buffered, the 


program is placed in 


the I/O suspend list until the operation is complete. RTF then reschedules the program. 


Assembly Language: 










EXT 


EXEC 






J SB 


EXEC 


Transfer control to RTE-III 




DEF 


RTN 


Return address 




DEF 


ICODE 


Request code 




DEF 


ICNWD 


Control information 




DEF 


IBUFR 


Buffer location 




DEF 


IBUFL 


Buffer length 




DEF 


IPRMl 


Optional parameter or track number if disc transfer 




DEF 


IPRM2 


Optional parameter or sector number if disc transfer 


RTN 


return 


point 


Continue execution (A = status, B = transmission log. If 
buffered WRITE, A and B are meaningless.) 


ICODE 


DEC 


1 (or 2) 


1=READ, 2=WRITE 


ICNWD 


OCT 


conwd 


conwd is described in Comments 


IBUFR 


BSS 


n 


Buffer of n words 


IBUFL 


DEC 


n(or -2n) 


Same n\ words (+) or characters (-) 


IPRMl 


DEC 


f 


Optional parameter or decimal track number if disc transfer 


IPRM2 


DEC 


Q 


Optional parameter or decimal sector number if disc transfer 


FORTRAN 










DIMENSION IBUFR(n) 


Set up buffer 




IBUFL 


= n 


Buffer length 




ICODE 


= 2 


Request code 




ICNWD 


= conwd 


Set Control Word 




REG=EXEC (IC0DE,ICNWD,IBUFR,IBUFL,IPRM1 ,IPRM2) 
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COMMENTS 

Parameters IPRMl and IPRM2 are optional, except in the 
case of disc transfers. If the data transfer involves a disc, 
IPRMl is the disc track number and IPRM2 is the disc 
sector number. In calls to other I/O devices these para- 
meters may have other uses. For example, driver DVR77 
(HP 23 23 A Subsystem) uses IPRMl for the scanner 
channel number and IPRM2 for the instrument program 
word. In some cases these parameters may be used to pass 
an additional control buffer to the driver (see Z-bit below). 

CONTROL WORD 

Figure 3-1 shows the format of the control word (conwd) 
required in the READ/WRITE calling sequence for DVROO 
driven devices. Several fields defining the nature of the data 
transfer are shown. 



15 



14 13 12 



11 10 9 



8 7 6 5 4 3 2 1 



H 



Z 



X A K V M 



— Function Code 



iVl I 



Logical | 

Unit# 

TPRTE-3 



Figure 3-1 . READ/WRITE (conwd) Format 

Note that if the logical unit bits are specified as zero, the 
call takes place but no data is transferred. 

Where 

M= for ASCII. 



X= When paper tape devices are used, "X" in combina- 
tion with "M" and "V" will indicate an honesty 
mode that is defined as follows: 

On input, if "X", "M", and "V" are set, absolute 
binary tape format is expected and handled. If "X" 
and "M" are set, and "V" is not, leader is not skipped 
and the specified number of words are read. On 
output, the record terminator (usually four feed 
frames) is not punched. 

On input, if "X" is set and "M" is not, ASCII tape 
format is expected. Leader is not skipped, bit 8 is 
stripped, but otherwise, all characters are passed to 
the user's buffer. The only exception is line-feed, 
which terminates the record. On output, carriage 
return and line-feed are suppressed; any trailing left 
arrow is not (i.e., left arrow is transmitted but 
carriage return/line feed is not). 

Z= 1 designates that IPRMl is the address of a control 
buffer and IPRM2 is the length of that buffer in 
words (only when the call is to be non-disc device). 
The Z-bit is passed to the driver. 

In an Assembly Language calling sequence, the buffer 
length (IBUFL) can be a positive number for words (+) or a 
negative number for characters (— ). 



M= 1 for binary. 



V= 



V= 



1 , and M = 1 , causes the length of punched tape input 
to be determined by the word count in the first 
non-zero character read from the tape. 

1 for the line printer will cause it to print column 
one. 



V= 0, and M = 1 , the length of the punched tape input is 
determined by the buffer length specified in the 
EXEC call. 

K= 1 causes keyboard input to be printed as received. If 
K = input from the keyboard is not printed. 

A= 1 designates punching (without printing) ASCII char- 
acters on the teleprinter (M = 0). (If A = 0, M 
determines mode of transfer.) This bit is effective on 
devices that recognize this control function. 



<$) Modified to contain request code before entry into driver. 



A- AND B- REGISTER RETURNS 

End-of-operation information is transmitted to the program 
in the A- and B-Registers. The A- Register contains word 5 
(status word) of the device EQT entry with bits 14 and 15 
indicating the end-of-operation status as defined by the 
driver completion code. This will be either 00-up, or 
01 -down. The B- Register contains a positive number which 
is the number of words or characters (depending upon 
which the program specified) actually transmitted. 

NOTE 

When a REAL array is transmitted, 
the buffer length must still be the 
total number of words required 
(i.e., 2 times REAL array length, or 
3 times double precision array 
length). 

If the request is for output to a buffered device, the 
registers are meaningless. 
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I/O AND SWAPPING 

Disc resident programs doing I/O are swappable under the 
following conditions: 

a. The buffer is not in the partition (i.e., it is in 
common or the resident hbrary). 

b. The device is buffered and the request is for 
output, and enough contiguous memory was allo- 
cated for buffering the record to be transferred. 

c. The buffer is contained in the Temporary Data 
Block (TDB) of a re-entrant routine, and enough 
contiguous memory was allocated to hold the TDB. 



Only the first buffer of a two buffer request (see Z-bit 
above) is checked to determine program swappability. It is 
the user's responsibility to put the second buffer in an area 
that implies the swappabiUty if conditions "a" or "c" are 
true. The system takes care of case "b". 



RE-ENTRANT I/O 

A subroutine called REIO is furnished to allow the user to 
do re-entrant I/O. REIO is a utihty type library routine and 
is more fully documented in Part 5 of Section IV, RTE-III 
Relocatable Libraries. 



CLASS I/O - READ/WRITE 



Purpose: 








To transfer information 


to or from an external non-disc I/O device or another program. Depending on parameter 


options, the calling program will not be suspended while the call completes. 


assembly Language: 








EXT 


EXEC 






J SB 


EXEC 


Transfer control to RTE-III 




DEF 


RTN 


Return address 




DEF 


ICODE 


Request code 




DEF 


ICNWD 


Control information 




DEF 


IBUFR 


Buffer location 




DEF 


IBUFL 


Buffer length 




DEF 


IPRMl 


Optional parameter 




DEF 


IPRM2 


Optional parameter 




DEF 


ICLAS 


Class word 


RTN 


return 


point 


Contine execution (A = zero or status, B meaningless) 


ICODE 


DEC 


numb 


17=READ, 18=WRITE, 20=WRITE/READ 


ICNWD 


OCT 


conwd 


conwd is described in Figure 3-1 


IBUFR 


BSS 


n 


Buffer of n words 


IBUFL 


DEC 


n (or - 2n) 


Same n; words (+) or characters (-) 


IPRMl 


DEC 


f 


Optional parameter 


IPRM2 


DEC 


Q 


Optional parameter 


ICLAS 


OCT 


class 


class is described in Comments 


FORTRAN: 










DIMENSION IBUFR (n) 






IBUFL 


= n 






ICODE 


= 20 






ICNWD 


= 






ICLAS 


= 






REG = 


EXEC (IC0DE,ICNWD,IBUFR,IBUFL,IPRM1 ,IPRM2,ICLAS) 
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COMMENTS 

Class I/O consists of a unique scheme of programming 
within the RTE-III System to effectively handle several 
programs addressing either other programs or I/O devices. 
The following description of class I/O relies upon a Glossary 
of Terms directly related to Class I/O (see Table 3-2). 

The maximum number of classes is established during 
system generation after the last system modules are loaded. 
The generator requests how many class numbers are to be 
established and the operator responds with a number 
between and 255. Once the numbers are estabUshed the 
system keeps track of them and assigns them (if available) 
to the calling program when a class I/O call is made and the 
Class Number parameter is set to zero. Once the number 
has been allocated, the user can keep it as long as desired 
and use it to make multiple class I/O Calls. When the user is 
finished with the number it can be returned to the system 
for use by some other class user. One example of using Class 
I/O is Class I/O Mailbox communication. The example 
program in Figure 3-3 and described in the following 
sequence of events, shows how this is accompUshed. 

Table 3-2. Glossary of Terms for 
Class Input/Output 



Term 


Description 


1. Class 


An account which is owned 




by a program which may be 




used by a group of programs. 


2. Class Number 


The account number referred 




to in number one. 


3. Class Users 


Programs that use the class 




number. 


4. Class Request 


An access to a logical unit 




number with a class number. 


5. Class Members 


Logical unit numbers that are 




currently being accessed in 




behalf of a class. Completion 




of access removes the associa- 




tion between class number 




and logical unit number (com- 




pletion of access is defined as 




when the driver Completes 




the request). 


6. Class Queue 


The set of uncompleted class 


(Pending) 


requests. 


7. Class Queue 


The set of all completed class 


(Completed) 


requests. The structure is first 




in, first out. 



a. User program PROGA issues a Class I/O call 
with the Class Number parameter set to zero and the 
logical unit number portion of the control word 
parameter set to zero. This causes the system to 
allocate a Class Number (if available) and the request 
to complete immediately. (Logical unit zero specifies 
a system "bit bucket" which implies immediate 
completion). 

b. When the WRITE/READ call completes, 
PROGA's data will have been placed in a system 
buffer and this fact recorded in the Completed Class 
Queue for this class. 

c. PROGA then schedules PROGB (the program 
receiving the data) and passes PROGB, as a parameter, 
the Class Number it obtained. 

d. When PROGB exgi^A^ it picks up the Class 
Number by calling ^RMPAR^hen using this Class 
Number, it issues a Class I/O Get Call to the class. 
PROGA's data is then passed from the system buffer 
to PROGB's buffer. 

The system handles a Class I/O call in the following 
manner. 

a. When the class user issues a Class I/O call (and 
the call is received), the system allocates a buffer 
from available memory and puts the call in the header 
(first 8 words) of this buffer. The call is placed in the 
pending class queue and the system returns control to 
the class user. 

b. If this is the only call pending on the EQT, the 
driver is called immediately, otherwise the system 
returns control to the class user and calls the driver 
according to program priority. 

c. If buffer space is not available, the class user is 
memory suspended unless bit 15 ("no wait") is set. If 
the "no wait" bit is set, control is returned to the 
class user with the A-Register containing a —2 
indicating no memory available. 

d. If the class number is not available or the I/O 
device is down, the class user is placed in the general 
wait list (status = 3) until the condition changes. 

e. If the call is successful, the A-Register will 
contain zero on return to the program. 

The buffer area furnished by the system is filled with the 
caller's data if the request is either a WRITE, or a 
WRITE/READ call. The buffer is then queued (pending) on 
the specified logical unit number. Since the system forms a 
direct relationship between logical unit numbers and EQT 
entries, the buffer can also be thought of as being queued 
on the EQT entry. 
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After the driver receives the Class I/O call (in the form of a 
standard I/O call) and completes, the system vi'ill: 

a. Release the buffer portion of the request if a 
WRITE. The header is retained for the Get call. 

b. Queue the header portion of the buffer in the 
Completed Class Queue. 

c. If a Get call is pending on the Class Number, 
reschedule the calling program. (This means that if 
the user issues a Class Get call or examines the 
completed Class Queue before the driver completes, 
the user has effectively beat the system to the 
completed Class Queue.) Note that the program that 
issued the Class I/O call and the program that issued 
the Class Get call do not have to be the same 
program. 

d. If there is no Get call outstanding, the system 
continues and the driver is free for other calls. 

When the user issues the Get call, the completed Class 
Queue is checked and one of the following paths is taken. 

a. If the driver has completed, the header of the 
buffer is returned (plus the data). The user (calling 
program) has the option of leaving the I/O request in 
the completed Class Queue so as not to lose the data. 
In this case a subsequent Get call will obtain the same 
data. Or the user can dequeue the request and release 
the Class number. 

b. If the driver has not yet completed (Get call 
beat system to the completed Class Queue), the 
calling program is suspended in the general wait list 
(status = 3) and a marker so stating is entered in the 
completed Class Queue header. If desired, the 
program can set the "no wait" bit to avoid 
suspension. In any case, when the driver completes, 
any program waiting in the general wait list for this 
class is automatically rescheduled. Note that only one 
program can be waiting for any given class at any 
instant. If a second program attempts a GET call 
before the first one has been satisfied it will be 
aborted (I/O error 10 10). 

IPRMl and IPRM2 are required as place holders in this 
request. They may also be used to pass information through 
to the Class I/O Get Call to aid in processing the request. 

For a combination class WRITE/ READ call, the driver 
should expect control data in the buffer IBUFR. The 
system will treat the request as a class WRITE in that the 
buffer must be moved prior to the driver call, and as a class 
READ in that the buffer must be saved after the driver 
completion. Note that the driver will receive a standard 
READ request (ICODE = 1) on this request. 



Refer to Figure 3-1 for the format of the control word 
{conwd) required in the class I/O READ/WRITE calling 
sequence. 

Figure 3-2 shows the format of the class word (ICLAS) 
required in the caUing sequence. To obtain a class number 
from the system the class portion (bits 1 2-0) of the word is 
set to zero. This causes the system to allocate a Class 
Number (if one is available) to the calling program. The 
number is returned in the ICLAS parameter when the call 
completes and the user must specify this parameter 
(unaltered) when using it for later calls. Bit 15 is the 
"no-wait" bit. When set the calUng program does not 
memory suspend if memory (or a class number) is not 
available. A-Register value when the program returns is as 
follows: 





"A" Value 








Reason 













OK-request done 


^1 








No class number 


-2 








No memory now or buffer limit 
exceeded. 


15 


14 13 12 


11 


10 


9 


8 7 6 


5 4 3 


2 1 


1 
No 
Wai 












t 








' Class Number 





TPRTE-4 



Figure 3-2. Class Number (ICLAS) Format 



When the user's program issues a Class I/O call the system 
allocates a buffer from available memory and puts the 
call in this buffer. The call is queued and the system 
returns control to the user's program. If memory is not 
available, three possible conditions exist: (1) The program 
is requesting more memory than will ever be available. In 
this case the program is aborted with a IO04 error. (2) The 
program is requesting a reasonable amount of memory but 
the system must wait until memory is returned before it 
can satisfy the calling program. In this case the program is 
suspended unless the "no wait" bit is set in which case a 
return is made with the A-Register set to -2. (3) If the 
buffer limit is exceeded the program will be suspended until 
this condition clears. If the "no wait" bit is set the program 
is not suspended and the A-Register is set to —2. 
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FTN,L 

PWOGMAM PROGA 

OlMfcNSION iaFf?(v^2) ,INAMEC3) 



C 

C DO ClASS W»ITfe/fteAQ TO LU-P', 

C 



ICLASbK 

CAUL £Jt&CC2C?,«,I»3KR,-6 4,IDUMY, JOUMV^ICLAS) 
C 
C StHEOULt ReCeiVr^JG PROGRAM AND PASS IT CLASS*. 



C 



I^AHE(U»5i^l2?9 
INAMe(2)«47507R 
INAME t3) ■41wi)p(0fl 
CALL exfcCCl^.INAMt,lCLAS) 



END 



FTN^L 

PRDURAM PROCfB 

DIMfcN^lON If3FR(32) iIPRAM(5) 
C 

C SAVE CLASS **, iPRAMCn 
C 

CALL RMPAf^CIPhlAM) 
C 

C ACCtPf DATA FROM PR06A USINt, CLASS GET CALL 
C AND RELFASE THE CLASS NUMBER, 
C 

CALL EXEC(2lrIPR4M(l),IBFR,32) 



Figure 3-3. Example of Class I/O Mailbox Communication 
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RTE-III 



I/O CONTROL 



Purpose: 

To carry out various 1/0 control operations, such as backspace, write end-of-file, rewind, etc. If the I/O device is 
not buffered, the program is placed in the I/O suspend list until the control operation is complete. 



Assembly Language: 



EXT EXEC 





JSB 


EXEC 




DEF 


RTN 




DEF 


ICODE 




DEF 


ICNWD 




DEF 


IPRAM 


RTN 


return 


point 


ICODE 


DEC 


3 


ICNWD 


OCT 


conwd 


IPRAM 


DEC 


n 



Transfer control to RTE-III 

Return address 

Request code 

Control information 

Optional parameter 

Continue execution (A = status, B meaningless. If call is 

buffered, A is meaningless) 

Request code = 3 
See Control Word 
Required for some control functions; see Control Word 



FORTRAN: 

Use the FORTRAN AUXILIARY I/O statements or an EXEC call sequence. 

ICODE = 3 Request code 

ICNWD = conwd 

IPRAM = X Optional; see Control Word 

REG = EXEC (ICODE,ICNWD,IPRAM) 



CONTROL WORD 

Figure 3-4 shows the format of the control word {conwd) 
required in the I/O control calling sequence. 



15 


r- 1 

14 13 12 


11 10 9 


8 7 6 5 


4 3 


1 
2 1 


— 1 — 



'^""'^ 




Logical 






Ur 


it# 





# 
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Figure 3-4 I/O Control {conwd) Format 
Function Code (Octal) Action 

Clear device 



00 
01 
02 



Write end-of-file (magnetic tape) 

Backspace one record (magnetic 
tape) 



Functional Code (Octal) 
03 

04 
05 
06* 
07 

10 
11 
12 



Action 

Forward space one record (mag- 
netic tape) 

Rewind (magnetic tape) 

Rewind standby (magnetic tape) 

Dynamic status (magnetic tape) 

Set end-of-paper tape— leader 
skipped on next input request 

Generate paper tape leader 

List output line spacing 

Write 3-inch gap (magnetic tape) 



0^ Modified to contain request code before entry into driver 
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Function Code (Octal) 



13 



14 



15 



Action 



Forward space file (magnetic 
tape) 

Backward space file (magnetic 
tape) 

Conditional form feed (see Line 
Printer Driver manual). 



The following functions are defined for DVROO. For more 
information see the driver manual 29029-60001. 

20 Enable terminal - allows terminal to schedule its 
program when any key is struck. 

21 Disable terminal - inhibits scheduling of terminal's 
program. 

22 Set time-out - the optional parameter is set as the 
new time-out interval. 

23 Ignore all further action requests until: 

a) The device queue is empty or 

b) An input request is encountered in the queue, 
or 

c) A restore control request is received. 

24 Restore output processing (this request is usually not 
needed). 



The following functions are defined for the 2644 cartridge 
tape units (CTU). (Function codes 01, 02, 03, 04, 06, 13, 
and 14 have the same meaning for CTU as for magnetic 
tape.) 



05 Rewind 

10 Write end -of- file if not just previously written or not 
at load point 

26 Write end-of-data 

27 Locate file number IPRAM (less than 256) 



Function Code octal 1 1 (hst output line spacing), requires 
the optional parameter IPRAM which designates the num- 
ber of lines to be spaced on the specified logical unit as 
shown below. 



IPRAM 

+n 

-n 





Teleprinter 

space n lines 
space n lines 
no line feed 




*The dynamic status request (06) is unbuffered by RTIOC 
so that the caller receives the true status of any device. This 
causes the caller to wait for previous requests he (and lower 
priority programs) has made to be processed. 
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CLASS I/O - CONTROL 



Purpose: 

To carry out various I/O control operations, such as backspace, write end-of-file, rewind, etc. The caihng program 
does not wait. 



Assembly Language: 



RTN 



EXT EXEC 



J SB EXEC 

DEF RTN 

DEF ICODE 

DEF ICNWD 

DEF IPRAM 

DEF ICLAS 

return point 



ICODE DEC 19 

ICNWD OCT conwd 

IPRAM DEC n 

ICLAS OCT class 



Transfer control to RTE-III 

Return address 

Request code 

Control information 

Optional parameter 

Class word 

Continue execution (A = class number, B meaningless) 



Request code = 19 

See Control Word 

Required for some control functions; see Control Word 

class is described in Comments 



FORTRAN: 

Use the FORTRAN auxiliary I/O statements or an EXEC call sequence. 



ICODE = 19 
ICNWD = conwd 
IPRAM = X 
ICLAS =j^ 



Request code 
See Control Word 
See Control Word 
Class Word 



REG = EXEC (ICODE, ICNWD, IPRAM, ICLAS) 



COMMENTS 

Refer to Figure 3-4 for the format of the control word 
(conwd) required in the Class I/O control calling sequence. 



Note that this call, with the exception of the ICLAS 
parameter is the same as the standard I/O control call. Also 
refer to the Class I/O Get Call for additional information. 
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CLASS I/O -GET 



Purpose: 








To complete the data transfer between the system and 


user program that was previously initiated by a Class 


request. 


' 






Assembly Language: 










EXT 


EXEC 






JSB 


EXEC 


Transfer control to RTE-III 




DEF 


RTN 


Return address 




DEE 


ICODE 


Request code 




DEF 


ICLAS 


Class word 




DEF 


IBUFR 


Buffer location 




DEF 


IBUFL 


Buffer length 




DEF 


IRTNl 


Optional parameter status word 




DEF 


IRTN2 


Optional parameter status word 




DEF 


I RTN 3 


Optional parameter class word 


RTN 


return 


address 


Continue execution (A = status, B = Transmission log) 


ICODE 


DEC 


21 


2 1 = class GET call 


ICLAS 


NOP 




class is described in Comments 


IBUFR 


BSS 


n 


Buffer of « words 


IBUFL 


DEC 


n (or -In) 


Same n; words (+) or characters (-) 


IRTNl 


NOP 




Location for IPRMl from READ/WRITE call 


IRTN2 


NOP 




Location for IPRM2 from READ/WRITE call 


IRTN3 


NOP 




Location for IPRM3 from READ/WRITE call 


FORTRAN: 










DIMENSION IBUFR (n) 






ICODE 


= 21 






IBUFL 


= n 






ICLAS 


= xO 






REG = 


EXEC (IC0DE,ICLAS,IBUFR,IBUFL,IRTN1 ,IRTN2,IRTN3) 



COMMENTS 

When the calling program issues a Class Get call, the 
program is telling the system that it is ready to accept 
returned data from a Class READ call or remove a 
completed Class WRITE or Control call from the completed 
Class list. If the driver has not yet completed (Get call beat 
system to the completed Class Queue), the calling program 
is suspended in the general wait list (status = 3) and a 
marker so stating is entered in the Class Queue header. 
When the driver completes, the program is automatically 
rescheduled. If desired, the program can set the "no wait" 
bit to avoid suspension. 



Figure 3-5 shows the format of the class word (ICLAS) 
required in Class Get Call. Bits 12-0 represent the Class 
Number and security code that the Get call is looking for. 
This Class Number is obtained (in unaltered form) from the 
original Class I/O READ, WRITE, CONTROL or 
WRITE/READ call. Bit 15 is the "no wait" bit. When set, 
the calling program does not suspend if the Class Request 
has not yet completed. Bit 14 is the "save" bit. When set, 
the buffer is not released; therefore, a subsequent Get call 
will return the same data. Bit 13 is the "de-allocate" bit. 
When set, the Class Number is not returned to the system. 
If bit 13 is zero and no requests are left in the Pending Class 
Queue, and no Class Requests for this class are waiting for 
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15 



14 13 12 



11 10 9 



r 1 

2 1 



■System Use 



-Class Number- 
■Do not de-allocate class number 
■Save Class Buffer 
-No Wait 
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Figure 3-5. Class Word (ICLAS) Format 

driver processing, the class is returned to the system. It is 
possible for the call to return the Class Number and data, or 
no data depending on if there is one class call left. Bits 14 
and 13 work in conjunction with each other. If bit 14 is set 
then the buffer will not be released. Therefore you cannot 
de-allocate the Class Number. That is, the Class Number 
cannot be released because there is still an outstanding 
request against it. 



BUFFER CONSIDERATIONS 

Several buffer considerations exist in the Class I/O Get call. 
They are as follows: 

a. The number of words returned to the user's 
buffer is the minimum of the requested number and 
the number in the Completed Class queue element 
being returned. 

b. If the original request was made with the "Z" 
bit set in the control word, then IPRMl returned by 
this call will be meaningless. 

c. The "Z" buffer will be returned if there is room 
for it (see "a" above) only if the original request was 
a READ or WRITE/READ (i.e., for WRITE requests 
no data is returned in the buffer area). 



Only when the Get call gets the last class request on a class, 
or on an empty class queue (completed and pending) can 
the user release the Class Number by clearing bit 1 3 in the 
ICLAS word. 

Three parameters in the call are return locations: that is, 
values from the system are returned to the calling program 
in these locations. Optional parameters IPRMl and IPRM2 
from the Class I/O - WRITE/READ calls are returned in 
IRTNl and IRTN2. These words are protected from 
modification by the driver. The original request code 
received by the driver is returned in IRTN3. For example: 



Original Request Code 
1 7/20(READ,WRITE/READ) 

18 (WRITE) 

19 (CONTROL) 



Value Returned in IRTN3 



A- AND B-REGISTER RETURNS 

The A- and B-Registers are set as follows after a Class I/O 
Get call. 



A-Register 



Al 5 = then A = status 



B-Register 

B = transmission log 
(positive words or characters 
depending on original request) 



A15 = 1 then A = —(numb+l)B = meaningless 

On return with data, bit 15 is set to zero and the rest of the 
A-Register contains the status word (EQT5). If a return is 
made without data (the "no wait bit" was set in the 
class word) then bit 15 is set to one and the A-Register 
contains the number of requests numb made to the class bit 
not yet serviced by the driver (i.e., pending class requests). 
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I/O STATUS 



Purpose: 

To request information (status condition and device type) about the device assigned to a logical unit number. 

Assembly Language: 

EXT EXEC 



Transfer control to RTE-III 

Return address 

Request code 

Control information 

Status word 1 

Status word 2 — optional 

Status word 3 — optional 

Continue execution (A and B are meaningless) 



Request code = 13 

Logical unit number 

Word 5 of EQT entry returned here 

Word 4 of EQT entry returned here, optional 

LU status returned here, optional 





JSB 


EXEC 




DEF 


RTN 




DEF 


ICODE 




DEF 


ICNWD 




DEF 


ISTAl 




DEF 


ISTA2 




DEF 


ISTA3 


RTN 


return 


point 


ICODE 


DEC 


13 


ICNWD 


DEC 


n 


ISTAl 


NOP 




ISTA2 


NOP 




ISTA3 


NOP 





ICODE =13 Request code 

ICNWD = nn nn is the logical unit number 

CALL EXEC (IC0DE,ICNWD,ISTA1,ISTA2,ISTA3) 



COMMENTS 

When this call is made the caUing program is not suspended. 
Equipment Table (EQT) words 5 and 4 (optional) are 
returned in ISTAl and ISTA2 and are defined as shown in 
Table 3-3. The STATUS portion of EQT word 5 is further 
broken down and shown in Table 3-4. 



The status of the specified LU is returned in 1ST A3. Bit 15 
indicates whether the device (LU) is up (0) or down (1). 
Bits 4-0 give the subchannel associated with the device. 
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WORD 



ISTA2 



ISTAl 



Table 3-3, I/O Status Word (ISTAl /ISTA2) Format 



15 



D 



1 1 

14 13 12 



AV 



CONTENTS 
— r- 



11 



10 



Unit# 



EQUIP. TYPE CODE 



1 



Channel # 



STATUS (see Table 3-4) 



D 
B 
P 

S 
T 

Unit 
Channel 



= 1 if DMA required. 

= 1 if automatic output buffering used. 

= 1 if driver is to process power fail. 

= 1 if driver is to process time-out. 

= 1 if device timed out (system sets to zero before each I/O request). 

= Last sub-channel addressed. 

= I/O select code for device (lov^er number if a multi-board interface). 



AV 



= availability indicator: 

= available for use. 

1 = disabled (down). 

2 = busy (currently in operation). 

3 = waiting for an available DMA channel. 

EQUIP. TYPE CODE = type of device. When this number is linked with "DVR." it identifies the 
device's software driver routine: 

00 to OVg = paper tape devices (or system control devices) 

00 = teleprinter (or system keyboard control device) 

01 = photo-reader 

02 = paper tape punch 

05 subchannel = interactive keyboard device (or system 

keyboard control devices) 

subchannel 1,2 = HP mini-cartridge device 

10 to 17 = unit record devices 

10 = plotter 

12 = line printer 

15 = mark sense card reader 

20 to 37 = magnetic tape/ mass storage devices 

3 1 = 7900 moving head disc 

32 = 7905 moving head disc 

40 to 77 = instruments 

STATUS = the actual physical status or simulated status at the end of each operation. 

For paper tape devices, two status conditions are simulated: Bit 5 = 1 
means end-of-tape on input, or tape supply low on output. 



3-16 



Exec Calls 



Table 3-4. EQT Word 5, STATUS Table. 



Device^\Status 


7 


6 


5 


4 


3 


2 


1 





Teleprinter(s) 
Photoreader(s) 
Punch(es) 
DVROO 


X 


- 


End of 

I/O 

Tape 


~ 


- 


STL 


TEN 


_.. 


2640 Terminal 
2644 Terminal 
Cartridge Tape Unit 
DVR05 


BF 

EOF 


TLP 


CD 
EOT 


RE 


LCA 


CWP 


TEN 
EOD 


CNE/DB 


7210 Plotter 
DVRIO 


- 


- 


" 


-- 


- 


- 


- 


PD 


2892 Card Reader 
DVRll 


HE 














RNR 


2767 Line Printer 
DVR12 












LCF 


LCF 


NE 


2607 Line Printer 
DVR12 


TOF 


DM 


ON 


RY 


X 


X 


Auto 

page 

eject 


X 


7261 Card Reader 
2761 Mark Sense 
Reader 
DVR15 


EOF 


- 


HE/SF 
HE/SF 


PF 
PF 


- 


- 


DE 
DE 


RNR 
RNR 


3030 Mag Tape 

7970 
DVR22 
DVR23 


EOF 


ST 


EOT 


TE 


I/OR 


NW 


PE 


DB/OL 


7900 Moving Head Disc 
DVR31 




NR 


EOT 


AE 


FC 


SC 


DE 


EE 


7905 Moving Head Disc 
DVR32 


PS 


FS 


HF 


FC 


SC 


NR 


DB 


EE 

r 


Where: 

PE = Parity Error NW = No Write (write enable TEN = Terminal Enabled 

HE = Hopper Empty ring missing or tape unit is rewinding) TOF = Top of Form 

SF = Stacker Full SC = Seek Check DM = Demand ( 1 = Idle) 

RNR = Reader Not Ready FC = Flagged Track (protected) X = Driver Internal Use 

PF = Pick Fail AE = Address Error STL = Stall required/ In 

DE = Data Error EOT = End of Tape program 

OL = Off Line NR = Not Ready PD = Pen Down 

ON = On Line RY = Ready (0 = power on) CD = Control-D Entered 

CE = Compare Error LCF = Last Character Flag BF = Buffer Flushed 

BT = Broken Tape NE = No Error CNI = Cartridge Not Inserted 

DB = Device Busy DR = Disc Ready EOD = End of Data 

EOF = End of file HF = Hardware Fault CWP = Cartridge Write Protected 

ST = Start of Tape PS = Protect Switch Set LCA = Last Command Aborted 

TE = Timing Error FS = Drive Format Switch is set RE = Read Error 

I/OR = I/O Reject EE = Error exists TLP = Tape at Load Point 
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DISC TRACK ALLOCATION 



JSB 


EXEC 


DEF 


RTN 


DBF 


ICODE 


DEF 


ITRAK 


DEF 


ISTRK 


DEF 


IDISC 


DEF 


ISECT 


return 


point 



Purpose: 

To request that RTE-III assign a specific number of contiguous disc tracks for data storage. The tracks are either 
assigned to the calling program or assigned globally. 

Assembly Language: 

EXT EXEC 



Transfer control to RTE-III 

Return address 

Request code 

Number of contiguous tracks required 

Start track number 

Disc logical unit number 

Number of 64 word sectors/track 

Continue execution (A and B are meaningless) 



4 = allocate track to program 

15 = allocate track globally 

n = number of contiguous tracks within the same disc unit 

requested. If bit 15 of ITRAK = 1 the program is not suspended if 

tracks are not available; if bit 15 = 0, the program is suspended until 

the tracks are available. 

RTE-III stores starting track number here, or -1 if the tracks are 

not available. 

RTE-III stores logical unit number here. 

RTE-III stores number of 64 word sectors/track here. 



Example (with no suspension): 

ICODE = 4 

ITRAK = I00000B + A7 

CALL EXEC (ICODE,ITRAK,ISTRK,IDISC,ISECT) 

Example (with suspension until tracks available): 

ICODE = 4 
ITRAK = // 
CALL EXEC (1C0DE,ITRAK,ISTRK,IDISC,ISECT) 



RTN 

ICODE DEC 4 or 1 5 

ITRAK DEC n 



ISTRK 



NOP 



IDISC 


NOP 


ISECT 


NOP 


FORTRAN: 





COMMENTS 

RTE-III supplies only whole tracks within one disc. When 
writing or reading from the tracks (see READ/WRITE 
EXEC Call), RTE-III does not provide automatic track 



switching; the user program (when using this call) is 
completely responsible for file and track management. 
RTE-III will prevent other programs from writing on 
program assigned tracks, but not from reading out of them. 
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The program retains the tracks until it or the operator 
releases them, or the program is aborted. 



Globally assigned tracks are available to any program for 

DISC TRACK RELEASE-PROGRAM TRACKS 



Exec Calls 



READ, WRITE, or release. The user is completely re- 
sponsible for their management. RTE-III will not prevent' 
other programs from writing on globally assigned tracks or 
releasing them. 



Purpose: 

To release some contiguous disc tracks which were previously assigned to a program (see Disc Allocation EXEC 
Call). 



Assembly Language: 






EXT 


EXEC 




JSB 


EXEC 




DEF 


RTN 




DEF 


ICODE 




DEF 


ITRAK 




DEF 


ISTRK 




DEF 


IDISC 


RTN 


return 


point 


ICODE 


DEC 


5 


ITRAK 


DEC 


n 


ISTRK 


DEC 


m 


IDISC 


DEC 


P 


FORTRAN: 







Transfer control to RTE-III 

Return address 

Request code 

Number of contiguous tracks, or -1 

Starting track number 

Disc logical unit 

Continue execution (A and B are meaningless) 



Release program's tracks 

If « = -1, release all tracks assigned to program; ISTRK and IDISC are 

unnecessary. Otherwise, n is the number of contiguous tracks to be 

released starting at ISTRK. 

Starting track number 

Disc logical unit 



Release of n contiguous tracks starting atm onLU p: 

ICODE = 5 

ITRAK = n 

ISTRK = m 

IDISC = p 

CALL EXEC (ICODE,ITRAK,ISTRK,IDISC) 

Release all tracks allocated to the program. 

ICODE = 5 

ITRAK = -1 

CALL EXEC (ICODE,ITRAK) 



COMMENTS 

When tracks are released, any program suspended waiting 
for tracks is rescheduled. 
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DISC TRACK RELEASE-GLOBAL TRACKS 



Purpose: 

To release some contiguous disc tracks which were previously assigned globally (see Disc Allocation EXEC Call). 

Assembly Language: 

EXT EXEC 



Transfer control to RTE-III 

Return address 

Request code 

Number of contiguous tracks 

Starting track number 

Disc logical unit 

Continue execution (A = track release status, B meaningless) 





JSB 


EXEC 




DEE 


RTN 




DEF 


ICODE 




DEF 


ITRAK 




DEF 


ISTRK 




DEF 


IDISC 


RTN 


return 


point 


ICODE 


DEC 


16 


ITRAK 


DEC 


n 


ISTRK 


DEC 


m 


IDISC 


DEC 


P 



Release global tracks 

The number of contiguous tracks to be .released starting at ISTRK 

Starting track number 

Disc logical unit 



FORTRAN: 

Release of ^z contiguous global tracks starting at m on LU p: 

ICODE = 1 6 

ITRAK = n 

ISTRK = m 

IDISC = p 

REG = EXEC (ICODE,ITRAK,ISTRK,IDISC) 



COMMENTS 

If any one of the tracks to be released is either not assigned 
globally or is currently in use (i.e., some program is queued 
to read or write on the track at the time of the release 
request), none of the tracks are released. 

The requesting program is rescheduled after the request 
with the A-Register set as follows: 



A= The tracks have been released. 

A=— I No tracks have been released — at least one of 
them was in use. 

A= —2 No tracks have been released — one or more of 
them was not assigned globally. 
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PROGRAM COMPLETION 



Purpose: 

To notify RTE-III that the calling program wishes to instigate a program termination. 

Assembly Language: 

EXT EXEC 





JSB 


EXEC 




DEF 


RTN 




DEF 


ICODE 




DEF 


INAME 




DEF 


INUMB 




DEF 


IPRMl \ 




DEF 


IPRM5 , 


RTN 


return 


point 


ICODE 


DEC 


6 




( DEC 





INAME 


or 






( ASC 


3, name 


INUMB 


DEC 


n 



IPRMl 
IPRM5 

FORTRAN: 



DIMENSION INAME(3) 

ICODE = 6 

INUMB = 

INAME(1)= 2Hcc 

INAME(2) = 2Hcc 

INAME(3)= IHc 

REG = EXEC (IC0DE,INAME,INUMB,IPRM1 . . . IPRM5) 

CALL RMPAR (IPRMl . . . IPRM5) to pick up the parameters 



Transfer control to RTE-III 

Return address 

Request code 

Name of program to be terminated — optional 

Type of completion — optional 

Up to five optional parameters — optional 

Continue execution (A = as it was, B = as 
it was or parameter address) 

Request code = 6 
Terminate this program 

name = Name of subordinate program to be terminated. 
n = 0, Normal completion 

« = ~1, Serial reusabiUty completion.When rescheduled, 
program is not reloaded into memory if it is 
still resident. 

n = 1 , Make program dormant but save current suspension 
point. 

n = 2, Terminates and removes from the time list the named 
program. If the program is I/O suspended, the system 
waits until the I/O completes before setting the pro- 
gram dormant; however, this call does not wait. The 
program's disc tracks are not released. 

n = 3, Terminates immediately the named program, removes 
it from the time list, and releases all disc tracks. If sus- 
pended for I/O, a system generated clear request is 
issued to the driver. An abort message is printed on 
the system TTY. 

Up to five optional parameters to be passed to caller when next 

scheduled (INAME = 0). 

See INAME above 

See INUMB above 

First two characters 

Second two 

Last character in upper 8 bits 
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COMMENTS 

This call, with its optional parameters, makes it possible for 
the user to selectively terminate programs he and only he 
has scheduled. For example, if PROGl ("Father") 
schedules PR0G2 ("Son") to run, and then later PR0G2 
schedules PROGS to run, PR0G2 becomes the "Father" to 
PR0G3 (a "Son"). In this case, only the following calls for 
Program Completion are legal. 

• PROG 1 terminates itself or PROG 2 

• PROG 2 terminates itself or PROG 3 

• PROG 3 terminates itself only. 

Option -1 (INUMB = -1) should be used only for programs 
that have serial reusabiUty. These are disc resident programs 
that can initialize their own buffers or storage locations. For 
instance, all library subroutines are serially resuable. When 
[NUMB = ~1, the program is reloaded from disc only if it 
is overlaid by another program. The program must be able 
to maintain the integrity of its data in memory. 



Option 1 (INUMB = 1) is almost the same as a Program 
Suspend EXEC call. In this case the program restarts from 
its point of suspension with all resources untouched. Unless 
the program suspended itself in this way, the program may 

only be restarted by the program that scheduled it 
("Father"), or the ON or RUN operator commands. If the 
program suspended itself (INAME = 0), it may be restarted 
by any normal run stimulus (i.e., Schedule, ON, RUN, 
TIME and Interrupt). 

Parameters IPRMl . . . IPRM5 are optional parameters that 
are passed to the caller when it is next scheduled. The 
parameters are passed onlx^^dlSlbiNAME = and may be 
recovered by a call (^oRMPAR wh^n the program next 
executes. In this way a program m the time list may run 
with the same parameters each time. 

Note that the FORTRAN and ALGOL compilers generate a 
Program Completion EXEC call automatically when they 
compile an END statement. 



PROGRAM SUSPEND 



Purpose: 










To suspend the calling program 


from execution until 


restarted by the GO operator request. 


Assembly Language: 


EXT 


EXEC 








JSB 


EXEC 




Transfer control to RTE-III 




DEF 


RTN 




Return address 




DEF 


ICODE 




Request code 


RTN 


return 


point 




Continue execution (A = as it was, B = as it v/as or 
parameter address) 


ICODE 


DEC 


7 




Request code = 7 


FORTRAN and ALGOL: 










The FORTRAN and ALGOL library subroutine PAUSE, 


which is automatically called by a PAUSE statement, 


generates the Suspend EXEC d 


dl. 









COMMENTS 

Note that it is illegal to suspend a Batch program with this 
call (error SCOO results). When a program is suspended 
(either by this call or the SS command), both the A- and 
B-Registers are saved and the program is placed in suspen- 
sion list 6. When the program is restarted with the GO 



request and no parameters, both registers are restored as 
they were at the point of suspension and the program 
continues. When the program is restarted with a GO and 
parameters, the B-Register contains the address of a 
five-word parameter array set by the GO request. In a 
FORTRAN program, a call to the Hbrary subroutine 
kCan load these parameters using the address in the 
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B-Register as a pointer as long as the RMPAR call occurs 
immediately after the EXEC call. It must be noted, 
however, that when RMPAR is used, parameters must 
accompany the GO request. Otherwise RMPAR uses the 
restored B-Register as an address to parameters which do 
not exist. If you suspect there might not by any para- 
meters, the following example shows how to allow for it. 

DIMENSION I(5),IREG(2) 

EQUIVALENCE (IREG,REG) , (IREG(2) ,IB) 

REG =0.0 

REG = EXEC (7) Suspend 

IF (IB) 20,20^10 

10 CALL ^^MPAR-^TlP^Re turn Point; get 

^'--— . -— — "^parameters 

20 CONTINUE Return point; no 

parameters 



When programming in ALGOL the parameters can be 
retrieved through RMPAR in the following manner. The 
variables are declared as integers and then RMPAR is called 
(immediately after the EXEC call). 
INTEGER A,B,C,D,E; 



j:X EC (7 2j ^ 
( ^'^FaR ( A )" "; \^^^ 

Obtaining theparameters in this manner depends on the 
compiler placing the contents of A,B,C,D,E in sequential 
locations. 

The Program Suspend EXEC Call is similar to the SS 
operator request (see Section II). 



PROGRAM SEGMENT LOAD 



Purpose: 

To load a background segment of the calling program from the disc into the background overlay area and transfer 
execution control to the segment's entry point. (See Section IV, Part 7, Real-Time Programming, for information 
on segmented programs.) 

Assembly Language: 







EXT 


EXEC 










JSB 

DEF 

DEF 

DEF 

DEF 


EXEC 
RTN 
ICODE 
INAME 
IPRMl . 




Transfer control to RTE-III 
Return address 
Request code 
Segment name 

Up to five optional parameters 




RTN 

ICODE 

INAME 


DEF 

return 

DEC 
ASC 


IPRM5 ^ 

point 

8 

3, name 




Control is transferred to the segment. (A 

ID segment address, B = as it was or pari 

address). 

Request code = 8 

name is the segment name 


FORTRAN: 
















DIMENSION NAME (3) 

ICODE = 8 

INAME (1) = 2Hcc First two characters 

INAME (2) = 2Hcc Second two 

INAME (3) = IHc Last character in upper 8 bits 

REG = EXEC (IC0DE,INAME,IPRM1 . . . IPRM5) 



segment 
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COMMENTS 

See Section IV, Overlay Segments and Segmented Pro- 
grams, for a description of segmented background pro- 
grams. 

On segment entry the registers are set as follows: 
A= Segment ID segment address. 



B= As it is unless parameters are passed in which case it is 
the parameter list address (see RMPAR). 

The FORTRAN examples are HP FORTRAN IV. For HP 

FORTRAN, the name of the segment must be converted 
from ASCII to octal and stored in the INAME array, two 
characters per word. Refer to the table in Appendix G 
for the ASCII to octal conversion. 



PROGRAM SCHEDULE 



Purpose: 

To schedule a program for execution. Up to five parameters and a buffer may be passed to the program. 

Assembly Language: 

EXT EXEC 



Transfer control to RTE-III 

Return address 

Request code 

Name of program to schedule 



RTN 



ICODE 



INAME 

IPRMl 

IPRM5 



J SB 


EXEC 


DEF 


RTN 


DEF 


ICODE 


DEF 


INAME 


DEF 


IPRMi 


DEF 


IPRM5 


DEF 


IPRM5 


DEF 


IBUFR 


DEF 


IBUFL 


return 


point 



DEC numb 



ASC 3 /lame 



IBUFR BSSn 

IBUFL DECn(or-2n) 



Up to five optional parameters 



Optional buffer address 
Optional buffer length 

Continue execution (A = program status, B = as it 
was or parameter address) 

9 = immediate schedule, with wait 
10 = immediate schedule, no wait 

23 = queue schedule, with wait 

24 = queue schedule, no wait 

name is the name of the program to schedule 

Up to five optional parameters 

Optional buffer of n words 

Same n ; words (+) or characters (-) 



FORTRAN: 



DIMENSION INAME(3),IBUFR(n) 

IBUFL = n 

ICODE = numb 

INAME(l) = 2Hcc 

INAME(2) = 2H cc 

INAME(3)=lHc 

REG = EXEC(ICODE,INAME,IPRML 



Set buffer length 
See ICODE above 
First two characters 
Second two 
Last character 
IPRM5, IBUFR,IBUFL) 
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COMMENTS 

The ICODE parameter determines if the calling program 
will wait or not, and if the calling program's schedule 
request will be queued until the scheduled program 
becomes dormant. 

When a program is scheduled, a pointer will be put in its ID 
segment that will: 

a. Point back to the program that scheduled it. 

b. Be set to if the program was scheduled by the 
operator, from an interrupt, or from the time list. 

The pointer will be cleared when the program terminates or 
is aborted. Note that this pointer establishes the program 
doing the scheduling as the "Father", and the program 
being scheduled as the "Son". 



All schedule combinations are legal: a disc-resident can call 
a core-resident, a core-resident can call a disc-resident, and a 
core-resident can call a core-resident. 

A Schedule EXEC Call with no wait (ICODE = 10) causes 
the specified program to be scheduled for execution 
according to its priority. 

ICODE = 23 or 24 

These requests are the same as 9 and 10 except that the 
system will place the "Father" in a queue if the "Son" is 
not dormant. When the "Son" becomes available the 
"Father's" request will be honored. Note that status will 
not be available in the A-Register and the "Father" will be 
impeded until the request is honored. 

OPTIONAL PARAMETERS 



As soon as a program that had been scheduled with wait 
completes, the "Father" may recover optional parameter 
one that indicates if the "Son" was aborted by the system 
or terminated by the OF operator command. The para- 
meter is set by the system to lOOOOOB and is recovered 
through RMPAR or a load B Indirect (LDA B,I). However, 
if the program does not pass back parameters and ter- 
minates normally, B will be set as it was on the call. 

ICODE = 9 OR 10 

If the program to be scheduled is dormant, it is scheduled 
and a zero is returned to the calling program in the 
A-Register. If the program to be scheduled is not dormant, 
it is not scheduled by this call, and its status (which is some 
non-zero value) is returned to the calling program in the 
A-Register. If the program to be scheduled is a "Son" that 
was suspended with the EXEC 6 call, some high bits may be 
set in the A-Register. Only the least 4-bits should be 
checked for zero in this case. 

A schedule with wait (ICODE = 9) call causes RTE to put 
the "Father" in a waiting status (the wait bit is set in the 
status word in the "Father's" ID segment). If required, the 
"Father" will be swapped by the system to make way for a 
program that may run. The "Son" runs at its own priority, 
which may be greater than, less than, or equal to that of the 
calling program. Only when the "Son" terminates does 
RTE resume execution of the "Father" at the point 
immediately following the schedule call. 

A disc-resident program may schedule another disc-resident 
program with waiting, because disc-resident programs are 
swapped according to their priority when they conflict over 
use of their core area. 



When the "Son" begins executing, the B-Register contains 
the address of a five-word Ust of parameters from the 
"Father'' (the parameters equal zero if none were spec- 
ified). A call to the Ubrary subroutine RMPAR, the first 
statement of a called FORTRAN program, transfers these 
parameters to a specified five-word array within the called 
program. For example: 

PROGRAM XQF 

D I ME N S I ON ,1 P RAM (5) 

GALirlMPAR~'( IPRAM) ""^ 



If the "Father" includes the optional buffer in his schedul- 
ing call, the buffer is moved to system available memory 
and assigned to the "Son." The "Son" can recover the 
buffer by using the String Passage EXEC call. If there is 
not enough system available memory to hold the buffer, 
but there will be in the future, the "Father" is memory 
suspended. If there will never be enough memory available 
for the buffer, the "Father" will be aborted with a SCIO 
error. If the no abort bit (bit 1 5 in ICODE) is set, the 
program will not abort. 

The Program Schedule EXEC Call is similar to the RU 
operator request (see Section II). The Execution Time 
EXEC Call also schedules programs for execution, but 
without passing parameters. 

For the schedule with wait requests (ICODE = 9 or 23), the 
"Son" may pass back five words to the "Father" by calling 
the Hbrary routine PRTN. For example: 

PROGRAI^l SCHEE 
DIMENSION IBACK(5^ 
CALL PRTN (IBACK) 
CALL EXEC (6) 
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The EXEC (6) call (which is a termination call) should 
immediately follow the PRTN caU. The "Father" may 
recover these parameters by calling RMPAR immediately 
after the "Son" call. 



For all schedule requests, the "Son" may pass back a buffer 
to the "Father" (see the String Passage EXEC call). 



TIME REQUEST 



Purpose: 






To request the current time recorded 


in the real-time clock 


Assembly Language: 








EXT 


EXEC 




JSB 


EXEC 




DEF 


RTN 




DEF 


ICODE 




DEF 


ITIME 




DEF 


lYEAR 


RTN 


return 


point 



ICODE 
ITIME 
lYEAR 



DEC 
BSS 
BSS 



FORTRAN 



Transfer control to RTE-III 

Return address 

Request code 

Time value array 

Optional year parameter 

Continue execution (A=meaningless, B as it was) 



Request code = 1 1 
Time value array 
Year (optional) 



DIMENSION ITIME(5),IYEAR(1) 

ICODE = 1 1 

CALL EXEC (ICODE,ITIME,IYEAR) 



COMMENTS 

When RTF returns, the time value array contains the time 
on a 24-hour clock, with the year in an optional parameter. 
The year is a full 4-digit year (e.g., 1976). 

Assembler FORTRAN/ALGOL 

ITIME or ITIME(l) = Tens of milliseconds 

ITIME+1 or ITIME(2) = Seconds 

ITIME+2 or ITIME(3) = Minutes 

ITIME+3 or ITIME(4) = Hours 

ITIME+4 or ITIME(5) = Day of the year 



The Time Request EXEC Call is similar to the TI operator 
request (see Section II). 



Another method of obtaining the current time is through a 
double word load from the system entry point $TIME. 
$TIME contains the double word integer of the current 
time of day. If this double word is passed to the library 
subroutine TMVAL, then TMVAL returns milliseconds, 
seconds, minutes, and hours. Refer to the Library, Part 6, 
Section V. 
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STRING PASSAGE 



Purpose: 

To retrieve the command string which scheduled the program or to pass a buffer back to the "Father" program. 

Assembly Language: 

EXT EXEC 





JSB 


EXEC 


Transfer control to RTF 




DEF 


RTN 


Return address 




DEF 


ICODE 


Request code 




DEF 


IRCOD 


Retrieve/write code 




DEF 


IBUFR 


Buffer location 




DEF 


IBUFL 


Buffer length 


RTN 


return 


point 


Continue Execution (A = status, B = number 
of words/characters) 


ICODE 


DEC 


14 


Request code 


IRCOD 


DEC 


1 or 2 


1 = retrieve parameter string 

2 = write buffer to "Father" 


IBUFR 


ESS 


n 


Buffer of n words 


IBUFL 


DEC 


n(oT -2n) 


Same n ; words (+) or characters (-) 


FORTRAN: 









DIMENSION IBUFR(n) 

IBUFL = n 

ICODE = 14 

IRCOD = 1 

REG = EXEC(ICODE,IRCOD,IBUFR,IBUFL) 



COMMENTS 

The command string retrieved is exactly like the string used 
in scheduling the program via RU, ON, GO commands or 
EXEC 9, 10, 23 or 24. The block of system available mem- 
ory used to store the command string (buffer) is released 
by this call or when the "Son" goes dormant. Any parsing 
of the returned string is left to the calling program. The 
RTF system library routine GETST can be used to recover 
the parameter string portion of the command string. 



Upon return from a retrieve operation, the A-Register con- 
tains status information : if the operation was successful 
or 1 if no string was found. The B-Register is a positive 
number giving the number of words (or characters) 
transmitted. If the string is longer than IBUFL, only IBUFL 
words are transmitted. If an odd number of characters are 
requested in a retrieve operation, the right half of the last 
word is undefined. 

If the write parameter string option is used, the call returns 
any block of system available memory associated with the 
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"Father" and allocates a new block for the "Father" into 
which the string will be stored. If no memory is currently 
available, the "Son" is memory suspended. If there will 
never be enough memory, and bit 15 of ICODE is not set, 
the "Son" is aborted with an SCIO error. If there is no 
"Father," execution continues at the return point with 
the A-Register equal to 1 . If the write parameter operation 
was successful, the A-Register is set to 0. 



NOTE 

Be careful when writing, a buffer to 
a "Father" when the "Father" 
scheduled the "Son" without wait 
(EXEC 10 or 24). It is the user's 
responsibility to insure synchroni- 
zation of the "Son's" write and 
the "Father's" read. 
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TIMED EXECUTION (Initial Offset) 



Purpose: 

To schedule a program for execution at specified time intervals, starting after an initial offset time. RTE-III pi 
the specified program in the time list and returns to the calling program. 

Assemhly Language: 



aces 





EXT 


EXEC 




JSB 


EXEC 




DEF 


RTN 




DEF 


ICODE 




DEF 


IPROG 




DEF 


IRESL 




DEF 


MTPLE 




DEF 


lOFST 


RTN 


return 


point 


ICODE 


DEC 


12 




DEC 





IPROG 


or 






[ ASC 


3,name 


IRESL 


DEC 


X 


MTPLE 


DEC 


y 


lOFST 


DEC 


-z 


FORTRAN: 







Transfer control to RTE-III 

Return address 

Request code 

Program to put in time list 

Resolution code 

Execution multiple 

Initial time offset 

Continue execution (A = meaningless, B as it was) 



Request code = 12 

Put calling program in time list 

name is the program to put in the time list 
Resolution code (1 = lO's/ms; 2=secs; 3=mins; 4=hrs) 
Execution multiple 
z (units set by x) gives the initial offset 



DIMENSION IPR0G(3) 

IPR0G(l) = 2Hcc 

IPR0G(2) = 2Hcc 

lPR0G(3)=lHc 

ICODE = 1 2 

IRESL = X 

MTPLE = J' 

lOFST = -z 

CALL EXEC (ICODE,IPROG,IRESL,MTPLE,-lbFST) 



See IPROG above 

First two characters 

Second two 

Last character in upper 8 bits 

(l = 10's/ms; 2=secs; 3=mins; 4=hrs) 

z (units set by x) gives the initial offset 



COMMENTS 



RUN ONCE 



The Execution Time EXEC Call is similar to the IT 
Operator request (see Section II). However, the EXEC Call 
places the program in the time list whereas IT does not. 
This call can schedule a program to execute in one of three 
ways as described in the following paragraphs. 



After a time offset and the program to be scheduled is 
dormant, the program will execute once and then be made 
dormant. This is accomplished as shown in the following 
example: 
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IRESL = 3 (specifies minutes) 

MTPLE = (specifies run once ) 

IOFST= -45 (specifies run after 45 minutes have 
elapsed from current time) 

RUN REPEATEDLY 

After a time offset and the program to be scheduled is 
dormant, the program will execute, go dormant, and then 
re-execute at specified intervals. This is accomplished as 
shown in the following example. 



IRESL = 3 (specifies minutes) 

MTPLE = 60 (specifies run every 60 minutes) 

IOFST= -30 (specifies run after 30 minutes have 
elapsed from current time) 

GO DORMANT; THEN RUN 

If IPROG=0, the current/calHng program is made dormant, 
but the point of suspension is retained. The program is then 
placed in the time list for rescheduUng from the point of 
suspension after a delay. When the program is rescheduled, 
it can be either to run once or repeatedly. 
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TIMED EXECUTION (Absolute Start Time) 



Purpose: 

To schedule a program for execution at specified time intervals, starting at a particular absolute time. RTE-III 
places the specified program in the time list and returns to the calling program. 



Assembly Language: 



EXT EXEC 





JSB 


EXEC 




DEF 


RTN 




DEF 


ICODE 




DEF 


IPROG 




DEF 


IRESL 




DEF 


MTPLE 




DEF 


IHRS 




DEF 


MINS 




DEF 


ISECS 




DEF 


MSECS 


RTN 


return 


point 


ICODE 


DEC 


12 




(dec 





IPROG 


or 




I ASC 


3,name 


IRESL 


DEC 


X 


MTPLE 


DEC 


y 


IHRS 


DEC 


a 


MINS 


DEC 


b 


ISECS 


DEC 


c 


MSEC 


DEC 


d 


FORTRAN: 







Transfer control to RTE-III 

Return address 

Request code 

Program to put in time list 

Resolution code 

Execution multiple 

Hours 

Minutes 

Seconds 

Tens of milliseconds 

Continue execution (A = meaningless, B as it was) 



Request code = 12 

Putting calling program in time list 

name is the program to put in the time list 

Resolution code (l = 10's/ms; 2=secs; 3=mins; 4=hrs) 

Execution multiple 

Absolute starting time 

In hours, minutes, seconds 

and tens of milliseconds 

on a 24-hour clock 



IPROG=0 or DIMENSION IPR0G(3) 

IPROG(l) = 2Hcc First two characters 

IPR0G(2) = 2Hcc Second two 

IPR0G(3) = IHc Last character in upper 8 bits 

ICODE = 1 2 

IRESL = x 

MTPLE =;; 

IHRS = h 

MINS = m 

ISECS = s 

MSECS = ms 

CALL EXEC (ICODE,IPROG,IRESL,MTPLE,IHRS,MINS,ISECS,MSECS) 



(l = 10's/ms; 2=secs; 3=mins; 4=hrs) 
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COMMENTS 

The Execution Time EXEC call is similar to the IT operator 
request (see Section II). However, the EXEC call places the 
program in the time list whereas IT does not. This call 
differs from the Initial Offset version in that a future 
starting time is specified instead of an offset. For example, 
if the current time is 1400 hours and you wish the program 
to run at 1545 hours the parameters would be as follows: 

IHRS = 15 

MINS = 45 
ISECS = 
MSECS= 

This call can schedule a program to execute in one of two 
ways as described in the following paragraphs. 



RUN ONCE 

After a time offset and the program to be scheduled is 
dormant, the program will execute once and then be made 



dormant. This is accomplished as 'shown in the following 
example. 



(specifies minutes) 
(specifies run once) 



IRESL 


= 


3 


MTPLE 


= 





IHRS 


= 


h 


MINS 


= 


m 


ISECS 


= 


s 


MSECS 


= 


ms 



(specifies absolute start-time) 



RUN REPEATEDLY 

After a time offset and the program to be scheduled is 
dormant, the program will execute, go dormant, and then 
re-execute at specified intervals. This is accomplished as 
shown in the following example: 



(specifies minutes) 
60 (specifies run every 60 minutes) 



► (specifies absolute start-time) 



IRESL 


= 


3 


MTPLE 


= 


60 


IHRS 


= 


h 


MINS 


= 


m 


ISECS 


= 


s 


MSECS 


= 


ms 
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PROGRAM SWAPPING CONTROL 



Purpose: 

To allow a program to lock itself into core (foreground or background) if the core locks were set up during 
generation. 



Assembly Language: 



EXT EXEC 





JSB 


EXEC 




DEF 


RTN 




DEF 


ICODE 




DEF 


lOPTN 


RTN 


return 


point 


ICODE 


DEC 


22 


lOPTN 


DEC 


numb 



FORTRAN: 



Transfer control to RTE-III 

Return address 

Request code 

Control information 

Continue execution (A = meaningless, B as it was) 



Request code = 22 

= program may be swapped 

1 = program may not be swapped 

2 = swap just the program area 

3 = swap all of the disc resident area 



ICODE = 22 

lOPTN = numb 

CALL EXEC (ICODE,IOPTN) 



COMMENTS 

This call allows the programmer to lock his program into 
core so it cannot be swapped out for a program of higher 
priority. Also the programmer can specify if just the 
program is to be swapped or if the entire fore- 
ground/background area is to be swapped with the pro- 
gram. 

NOTE 

The program cannot be locked into 
core if the core lock bits (base 
page word 1736B, bits 2 and 3) 
are not set (SC07 error results). 
The bits are set during generation. 



The program's core lock bit (lOPTN = or 1) is set or 
cleared by this request (refer to ID segment word 15, bit 6 



in Table A-1). This bit is also cleared (making the program 
swappable) if the program aborts or terminates except on 
the Program Completion EXEC Call where the current 
suspension point is saved. 

The program's core usage bit (lOPTN = 2 or 3) is also set or 
cleared by this request (refer to ID segment word 15, bit 5 
in Table A-1). The bit is initiaUzed when the program is 
scheduled as follows: 



Foreground program 
Background programs 



bit is cleared 
bit is set 



The system sets this bit whenever it loads a segment for the 
program. If the bit is not set, the segment area is not 
swapped, that is, the segment occupies undeclared core. 

When lOPTN = 3, the calling program tells the system that 
it is going to use undeclared core in its disc resident area. 
When the program is swapped, the whole disc resident area 
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is swapped. This allows the program to save working area When lOPTN = 2, the calling program tells the system that 
that it had set up. it is not going to use undeclared core in its disc resident 

area. Only the program itself is swapped. 

RESOURCE MANAGEMENT (Resource Numbering) 



Purpose: 








To allow cooperating .prog 


rams a method of 


efficiently utilizing resources through a resource numbering scheme. 


Assembly Language: 


1 






EXT 


RNRQ 






JSB 


RNRQ 


Transfer control to subroutine 




DEF 


RTN 


Return address 




DEF 


ICODE 


Control information 




DEF 


IRN 


Buffer location 




DEF 


ISTAT 


Status parameter 


RTN 


return 


point 


Continue execution (A = meaningless, B as it was) 


ICODE 


OCT 


numb 


numb is described in Comments. 


IRN 


BSS 


1 


Resource number. Returned on allocate; required otherwise. 


ISTAT 


BSS 


1 


Status of resources. 


FORTRAN: 










ICODE = 


numb 






CALL RNRQ {IC0DE,IRN,1STAT) 



COMMENTS 

Figure 3-6 shows the format of the control word {numb) 
required in the calling sequence. 



15 


14 


5 


4 


3 


2 


1 





Wait 
Option 




Allocate 
Option 


Set 
Option 


NO 

W 

A 

1 
T 


NO 
A 
B 


R 

T 


C 

L 
E 
A 
R 


G 
L 

B 

A 

L 


L 

C 

A 

L 


C 

L 
E 
A 
R 


G 

L 

B 

A 

L 


L 

C 
A 

L 



Reserved For 
System Use 



TPRTE-7 



Figure 3-6. Resource Number Control Word Format 



If more than one bit is set in the control word, the 
following order of execution is used: 

1. Local allocate (skip 2 if done). 

2. Global allocate. 

3. Deallocate (exit if done). 

4. Local set (skip 5 if done). 

5. Global set. 

6. Clear. 

The status return word (ISTAT) has the following mean- 
ings: 

ISTAT Value Meaning 

Normal deallocate return 

1 RN is clear (unlocked). 

2 RN is locked locally to caller. 

3 RN is locked globally. 

4 No RN available now. 
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1ST AT Value 



Meaning 



5 

6 RN is locked locally to other program. 

7 RN was locked globally when request was 
made. 

Note that status 4, 6, and 7 are returned only if the request 
failed and the "no wait" bit is set. 

NO ABORT BIT 

The no abort bit is used to alter the error return point of 
this call as shown in the following example. 

CALL RNRQ (I CODE .. .) 
GO TO error routine 
normal return 

This special error return is established by setting bit 14 to 
"1" in the request code word (ICODE). This causes the 
system to execute the first line of code following the CALL 
RNRQ if there is an error, or if there is no error, the second 
line of code following the CALL RNRQ. 

ALLOCATE OPTIONS 



unless the "no wait" bit is set (see the ICODE parameter). 
If the "no wait" bit is set, the IRN location is set to zero. If 
the RN allocation is successful, the value returned in IRN is 
set by the system (it has no meaning to the user) and must 
be specified (through IRN) when a lock is requested or the 
RN is cleared or de-allocated. 

SET OPTIONS 

LOCAL - Lock the specified RN to the calling program. 
The RN is specified in the IRN parameter. The local lock is 
automatically released on termination of the calling pro- 
gram, and only the calling program can clear the number. 

GLOBAL - Lock the specified RN globally. The RN is 
specified in the IRN parameter and the calhng program can 
globally lock this number more than once. The number is 
released by a request from any program. 

CLEAR — Release the specified number. 

If the RN is already locked, the calling program is 
suspended (unless the "no wait" bit is set) until the RN is 
cleared. If more than one program is attempting to lock an 
RN, the program with the highest priority is given 
precedence. 



LOCAL - Allocate an RN to the calling program. The 
number is returned in the IRN parameter. The number is 
automatically released on termination of the calling pro- 
gram, and only the calling program can de-allocate the 
number. 



If a program makes this call with the "clear" bit set, in 
addition to either the "global" or "local set" bits, the 
program will wait (in the general wait Hst) until the RN is 
cleared by another program and then continue with the RN 
clear. 



GLOBAL - Allocate an RN globally. The number is 
released only by a request from any program. 

CLEAR — De-allocate the specified number. 



An entry point is provided for drivers or privileged 
subroutines that wish to clear a global (and only a global) 
RN. 



The system has a certain quantity of resource numbers 
(UN's) that are specified during generation. If a number is 
not available, the program is suspended until one is free. 



LDA RN 
JSB $CGRN 
return point 
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LOGICAL UNIT LOCK 



Purpose: 

To allow a program to exclusively dominate (lock) input/output devices (logical unit, or LU numbers). 

Assembly Language: 

EXT LURQ 



Transfer control to subroutine 
Return address 
Control parameter 
LU's to be locked 
Number of LU's to be locked 
RTN return point Continue execution (A = lock status, B as it was) 



JSB 


LURQ 


DBF 


RTN 


DEF 


lOPTN 


DEF 


LUARY 


DEF 


NOLU 


return 


point 



lOPTN 



OCT 



numb 



LUARY 



DEC 


XX 


DEC 


yy 


DEC 


zz 



NOLU 



DEC 



aa 



numb is an octal number: 

OjcOOOO — unlock specified LU's 

IjcOOOO - unlock all LU's program currently has locked 

O^cOOOl - lock with wait specified LU's 

1x0001 - lock without wait specified LU's 

X (bit 14) is the no abort bit, x = 4 to set 'no abort', else x = 

LUARY is an array of LU's to be 

locked/unlocked. Only the least 

6 bits of each word are used. 



Number of LU's to be locked/unlocked. 



FORTRAN: 



DIMENSION LUARY (jc) 

lOPTN = numb 

NOLU = aa 

CALL LURQ (IOPTN,LUARY,NOLU) 



COMMENTS 

This request allows up to 31 programs to exclusively 
dominate (lock) an input/output device (e.g., program out- 
put to a line-printer). Any other program attempting to use 
or lock a locked LU wiU be suspended until the original 
program unlocks the LU or terminates. 

NO ABORT BIT 

The no abort bit is used to alter the error return point of 
this call as shown in the following example. 

CALL LURQ (lOPTN . . . ) 
GO TO error routine 
normal return 



This special error return is established by setting bit 14 to 
"1" in the request code word (ICODE). This causes the 
system to execute the first line of code following the CALL 
LURQ if there is an error, or if there is no error, the second 
hne of code following the CALL LURQ. 

UNLOCK 

To unlock all owned LU's, the LUARY array is not used but 
still must be coded; the program wiU not abort. 

Any LU's the program has locked will be unlocked when 
the program (1) does a standard terminate, (2) does a serial 
reusability terminate, or (3) aborts. Note that LU's wiU not 
be unlocked when the program does a "save resources 
terminate". 
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This subroutine calls the Program Management subroutine 
(RNRQ) for a resource number (RN) allocation. That is, 
the system locks an RN number locally to the caUing 
program. Therefore, before the logical unit lock subroutine 
can be used, a resource number must have been defined 
during generation. Note that the first 31 Resource Numbers 
can be used for LU locks. 

If the no wait option is coded the A=Register wiU contain 
the following information on return. 



A = ~ LU lock successful. 

A 7^ — LU lock unsuccessful. 

A= -1 - No RN available this time. 

A = 1 - One or more of the LU's is already locked. 

Note that the calling program may not have LU's locked at 
the time of this call unless the no wait option is used. Also, 
all the LU's that the calling program locks are locked to the 
same RN. 



PARTITION STATUS 



Purpose: 

To return information on the status of a particular partition. The status information provides the starting page 
number, the number of pages in the partition, whether the partition is reserved, and whether it is a real-time or 
background partition. If the partition contains a program, the index into the keyword table for the ID segment 
is returned. 

Assembly Language: 

EXT EXEC 



Transfer control to RTE-III 
Return address 
Request code 
Partition number 

Location where starting page is returned 
Location where number of pages is returned 
Location where partition status is returned 
RTN 



Partition status request code = 25 

Partition number 

Starting page number returned here (0 if illegal partition number) 

Number of pages returned here (-1 if illegal partition number) 

Partition status returned here (see comments) 



ICODE=25 

IPART=« where n is the partition number 

CALL EXEC (1C0DE,IPART,IPAGE,IPNUM,ISTAT) 



JSB 


EXEC 


DEF 


RTN 


DEF 


ICODE 


DEF 


IPART 


DEF 


IPAGE 


DEF 


IPNUM 


DEF 


ISTAT 


return 


point 



ICODE 


DEC 


25 


IPART 


DEC 


n 


IPAGE 


BSS 


1 


IPNUM 


BSS 


1 


ISTAT 


BSS 


1 


FORTRAN: 







COMMENTS 

The status word ISTAT contains status information as follows: 



15 14 



7 



PR 


RT 





ID segment | 



3-37 



RTE-III 



Where: 



PR 



RT = 



= 1 if the partition is reserved for programs 

requesting it. 
= if the partition is not reserved 
= 1 for a real-time partition 
= for a background partition 



If the partition contains a program, the index into the key- 
word table for the ID segment is returned in bits 0-7 of 
1ST AT; otherwise these bits are set to zero. 



ERROR MESSAGES 

When RTE-III discovers an error in an HXEC call, it 
terminates the program, releases any disc tracks assigned 
to the program, prints an error message on the operator 
console, and proceeds to execute the next program in 
the scheduled Ust. Table 3-5 is a summary of the possible 
errors associated with all the EXEC calls. Refer to 
Appendix E for other system errors. 



Wlien RTE-III aborts a program, it prints the following 
message: 

name ABORTED 

When a memory protect violation occurs that is not an 
EXEC call, a resident library call, or $LIBX or $LIBR 
call, the following message is printed: {address is the lo- 
cation that caused the violation. 

MP name address 

When an EXEC call contains an illegal request code, the 
following message is printed: {address is the location that 
made the illegal call). 

RQ name address 

An RQOO error means that the address of a returned 
parameter is below the memory protect fence. 

The following errors have the same format as "MP" and 
"RQ" errors. 

Error Meaning 

DM Program tried to access a page not included in its 

logical memory (similar to MP). 
TI Batch program exceeds allowed time. 

RE Re-entrant subroutine attempted recursion. 



The general error format, for other errors, is: 
type name address 



Where 

type is a 4-character error code. 

name is the program that rnade the call. 

address is the location of the call (equal to the 
exit point if the error is detected after 
the program suspends). 

ERROR CODES FOR DISC ALLOCATION CALLS 

DROl = Not enough parameters. 

DR02 = Number of tracks zero, illegal logical unit; 
or number of tracks to release is zero or neg- 
ative. 

DR03 = Attempt to release track assigned to another 
program. 

ERROR CODES FOR SCHEDULE CALLS 

SCOO = Batch program attempted to suspend (EXEC 
(7)). 

SCOl > = Missing parameter. 

SC02 = Illegal parameter. 

SC03 = Program cannot be scheduled. 

SC03 INT = occurs when an external interrupt attempts 
to schedule a program that is already 
scheduled. RTE-III ignores the interrupt and 
returns to the point of interruption. 

SC04 = name is not a subordinate (or "son") of the 
program issuing the completion call. 

SC05 = Program given is. not defined. 

SC06 = No resolution code in Execution Time 
EXEC Call (not 1,2, 3, or 4). 
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SC07 = Prohibited core lock attempted. 

SCIO = Not enough system available memory for 
buffer passage. 



1009 = Overflow of load-and-go area. 

10 10 = Class Get and one call already outstanding 

on class. 



ERROR CODES FOR I/O CALLS 

1000 = Illegal class number. Outside table, not 

allocated, or bad security code. 

1001 = Not enough parameters. 

1002 = Illegal logical unit, or less than 5 parameters 

with X bit set. 

1003 = Not used. 

1004 = Illegal user buffer. Extends beyond FG/BG 

area or not enough system memory to 
buffer the request. 

1005 = Illegal disc track or sector. 

1006 = Reference to a protected track; or using 

LG tracks before assigning them (see LG, 
Section II). 

1007 = Driver has rejected call. 

1008 = Disc transfer longer than track boundary. 



ERROR CODES FOR PROGRAM MANAGEMENT 

RNOO = No option bits set in call. 

RNOl = Not used. 

RN02 = Resource number not defined. 

RN03 = Unauthorized attempt to clear a LOCAL 
Resource Number. 

ERROR CODES FOR LOGICAL UNIT LOCK CALLS 

LUOl = Program has one or more logical units locked 
and is trying to LOCK another with WAIT. 

LU02 = Illegal logical unit reference (greater than 
maximum number). 

LU03 = Not enough parameters furnished in the call. 

) 
LU03 = Not enough parameters furnished in the call. 
Logical unit reference less than one. Logical 
unit not locked to caller. 
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Table 3-5. Summary of EXEC Call Errors 



ERROR MEANING 


READ 
1 


WRITE 

2 


CONTROL 
3 


PROGRAM 

TRACK 

ALLOCATE 

4 


PROGRAM 

TRACK 

RELEASE 

5 


PROGRAM 
COMPLETION 

6 


PROGRAM 
SUSPEND 

7 


PROGRAM 

SEGMENT 

LOAD 

8 


PROGRAM 

SCHEDULE 

W/WAIT 

9 


PROGRAM 

SCHEDULE 

WO/WAIT 

10 


TIME 
REQUEST 

11 


Not Enough Parameters 
1, Less than 4 parameters. 

DROl ^' ^^''^ "'^" ' parameter. 

3. Number = -1. 

4. Less than 3 (not-1). 








1 


2 
4 














Illegal Track Number or 
Logical Unit Number. 
DR02 '■ Track number = 0. 

2. Logical Unit not 2 or 3. 

3. Dealocate or less Tracks. 








1 


2 

3 














„ Attempt to release Track 
DROo assigned to another program. 










X 














Illegal Class Number 
TOnO ^- Outside Table. 
njuu 2. Not allocated. 

3. Bad Security Code. 
























Not Enough Parameters. 

1. Zero parameters. 

2. Less than 3 parameters. 
lOOl 3. Less than 5/disc. 

4. Less than 2 parameters. 

5. Qass word missing. 


1 
2 
3 


1 
2 
3 


1 


















Illegal Logical Unit 
1. or maximum. 
IO02 2. Class request on disc LU. 
3. Less than 5 parameters and 
X-bit set. 


1 
3 


1 
3 


1 


















Illegal User Buffer. 
1. Extends beyond FG/BG area. 
IO04 2. Not enough system memory to 
buffer the request. 


1 






















Illegal Disc Track or Sector 
_ 1. Track number maximum. 
1O05 2. Sector number 


1 
2 


1 
2 




















Attempted to WRITE to LU2/3 
and track not assigned to user 
IO06 or globally, or not to next 
load-and-go sector. Illegal 
WRITE to a EMP track. 




X 




















Tnn7 Driver has rejected request 
'■^^ ' and request is not buffeted. 


X 


X 


X 


















Tr»n« Disc transfer implies track 
^'-'"° switch (LU2/3) 


X 


X 




















IO09 Overflow of load-and-go area. 




X 
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PROGRAM 

SCHEDULE 

TIME 

12 


I/O 
STATUS 

13 


STRING 
PASSAGE 

14 


GLOBAL 

TRACK 

ALLOCATE 

15 


GLOBAL 

TRACK 

RELEASE 

16 


CLASS 

I/O 
READ 

17 


CLASS 

I/O 
WRITE 

18 


CLASS 

I/O 

CONTROL 

19 


CLASS 

I/O 

WRITE/READ 

20 


CLASS 
I/O 
GET 
21 


PROGRAM 
SWAPPING 
CONTROL 

22 


PROGRAM 

SCHED QUEUE 

W/WAIT 

23 


PROGRAM 

SCHED QUEUE 

WO/WAIT 

24 


RNRQ 


LURQ 








1 


3 
4 




























1 


2 
3 






























































1 
2 
3 


1 
2 
3 


1 
2 
3 


1 
2 
3 


1 
2 
3 














1 
4 








1 
2 

5 


1 
2 

5 


1 
5 


1 

2 

5 
















1 








1 
2 
3 


1 
2 
3 


1 
2 
3 


1 
2 
3 
























2 


2 


2 


2 


1 






























































































































































































1 
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i:rror meaning 


READ 


WRITE 


CONTROL 


PROGRAM 

TRACK 
ALLOCATE 


PROGRAM 

TRACK 
RELEASE 


PROGRAM 
COMPLETION 

ft 


PROGRAM 
SUSPEND 

7 


PROGRAM 

six;ment 

LOAD 


PROGRAM . 
SCIUvDULf: 

w/WAir 


PROCiRAM 
SCIIl-DL'Li: 

wo/WAir 


llME 
REOUl SI 

1 1 _ 


Class GET and one call already 
























Program has one or more logical 
LUOl units locked and is trying to 
LOCK another with WAIT. 
























Illegal logical unit reference 
(greater than maximum number). 
























Not enough parameters furnished 
in the call. Illegal logical unit ref- 
'-^"^ crence (less than one). Logical 
unit not locked to caller. 
























Return bulfer below memory pro- 
'*'^"" tect fence. 


X 






X 














X 


EXEC call contains an illegal re- 
quest code. 

1 . Return address indicates less 
than one or more than seven 

RQ parameters. 

2. Parameter address indirect 
through A- or B-Register. 

3. Request code not defined or 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


RNOO No option bits set. 
























RNOl Not used. 
























Resource number not in Table 
■'NO^ (undefined). 
























Unauthorized attempt to clear a 
LOCAL Resource Number. 
























SCOO Batch program cannot suspend. 














X 










Missing Parameter. 

1. Seginent name missing. 

2. Not 4 or 7 parameters in Tiine 
SC'Ol Call. 

3. Not 4 parameters in String 
















1 








Illegal Paratneter 

1. Option word is inissing or not 
SC02 0,1, 2, or 3. 

2. Read/write word in String Pass- 
age Call is not 1 or 2. 












1 












Program Cannot Be Scheduled. 
SC03 I. Not a segment. 
2. Is a segment. 
















1 


2 


2 




Attempted to control a program 
^'-"^ that is not a "Son." 












X 












Program Given is Not Defined. 
SC05 1. No segment. 

2. No program. 

3. "Son" not found. 












3 




1 


2 


2 




SC06 Resolution not 1, 2, 3, or 4. 
























SC07 Prohibited core lock attempted. 
























. Not enough systein available 
memory for string passage. 


















X 


X 
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PROGRAM 

SCHEDULE 

TIMI-; 

12 


1/0 
STATUS 

13 


STRING 
PASSAGE 

14 


GLOBAL 

TRACK 

ALLOCATE 

15 


GLOBAL 

TRACK 

RELEASE 

16 


CLASS 

1/0 
READ 

17 


CLASS 

1/0 
WRITE 

18 


CLASS 

1/0 

CONTROL 

19 


CLASS 

1/0 

WRITE/READ 

20 


CLASS 
1/0 
GET 
21 


PROGRAM 

SWAPPING 

CONTROL 

22 


PROGRAM 

SCHED QUEUE 

W/WAIT 

''3 


PROGRAM 

sriii;D QUi:uE 

WO/WAIT 


RNRQ 


LURQ 






















X 










































X 
































X 
































X 






X 




X 






X 


X 


X 


X 














X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


































X 
































































X 
































X 






































2 




3 
































2 
















1 


































2 


2 








































2 






















2 


2 




























































X 
















X 


















X 


X 
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SECTION IV 
REAL-TIME PROGRAM PREPARATION 



This section is divided into six parts that describe the 
operating procedures and formatting conventions of back- 
ground programming aids of the RTE system. The memory 
requirements stated apply to the program plus a reasonable 
area for symbol tables where appropriate. 



ALGOL, or FORTRAN compilers on LG tracks. The 
program can optionally be loaded into the background 
and run; or the program can be loaded into the background 
with the DEBUG library routine linked to it; or the 
program can be loaded into the disc-resident user program 
area. 



PARTL RTE FORTRAN 

The FORTRAN compilers accept source programs from 
either an input device or a source file created by the RTE 
Editor, and translates the source programs into relocatable 
object programs. The relocatable code is written to a 
device or stored in the LG tracks of the disc or both. 



PART 2. RTE ALGOL 

The ALGOL compiler accepts source programs from either 
an input device or a source file created by the RTE Editor, 
and translates the source programs into relocatable object 
programs. The relocatable code is written to a device or 
stored in the LG tracks of the disc or both. 



LG TRACK AREA 

The loader also provides the facility for compilation or 
assembly, loading, and executing a user program without 
intervening object tapes. To accomplish this, the compiler 
or assembler stores the relocatable object code, which it 
generates from source statements, on the disc in a pre- 
defined group of tracks called LG Tracks (see LG operator 
request). Then separate operator requests initiate loading 
(RU, LOADR) and execution (RU, program). All of the 
operating procedures have optional parameters that specify 
source input, relocatable output, and Hst device. These 
parameters take the form of logical unit numbers as follows: 



PARTS. RTE ASSEMBLER 

The Assembler accepts source programs from either an 
input device or a source file created by the RTE Editor, and 
translates the source programs into either absolute or relo- 
catable object programs. Absolute code is punched in 
binary, suitable for execution outside of RTE. The relocat- 
able code is written to a device or stored in the LG tracks 
of the disc or both. 



PART 4. RTE RELOCATING LOADER 

The loader accepts relocatable object programs from either 
an input device, or a file created by the Assembler, 



Logical Unit Number Function 






Bit Bucket 


1 


System Teleprinter 


2 


System Disc 


3 


Auxiliary Disc 


4 


Standard Output Device 


5 


Standard Input Device 


6 


Standard List Device 
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10 



Can be assigned to any devices by 
the user, for the defined range of 
logical units. 



63^0 f 



Note that LU8 is recommended as the magnetic tape 
device. 



PART 5. RTE RELOCATABLE LIBRARY 

This part describes the libraries used by RTE, re-entrant 
subroutine structure, privileged subroutine structure, and 
utility subroutine structure. 

PART 6. SEGMENTED PROGRAMS 

This part describes the procedures for writing segmented 
programs in Assembler, ALGOL, and FORTRAN. 

PART 7. MULTIPLE TERMINAL OPERATION 

This part describes the operation and configuration of the 
multi-terminal moniter. 
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PART 1 
RTE FORTRAN 



Regular FORTRAN and FORTRAN IV are segmented pro- 
grams that execute in the background under control of 
RTE-III. The compilers consist of a main program and 
overlay segments, and reside in the protected area of the 
disc. 



RU,FTN/FTN4 



RTE FORTRAN, a problem-oriented programming lan- 
guage translated by a compiler, is very similar to regular 
HP FORTRAN. Source programs, accepted from either 
an input device or disc LS Tracks, are translated into re- 
locatable object programs, and stored in the LG tracks of 
the disc and/or on an output device. The object programs 
can be loaded by the RTE Relocating Loader and executed 
by an ON operator request. When a FORTRAN program 
has been completely debugged, the RTE Relocating Loader 
can make it a permanent part of the RTE-III System if 
desired. 



FORTRAN REFERENCE 

For a complete description of the regular HP FORTRAN 
Language, read the FORTRAN Programmer's Reference 
Manual (02116-9015). For a complete description of the 
HP FORTRAN IV Language, read the FORTRAN IV Pro- 
grammer's Reference Manual (5951-1321). 

COMPILER OPERATION 

An RU, FTN operator request schedules the regular RTE-III 
FORTRAN compiler for execution. If FORTRAN IV is 
used, the operator request is RU, FTN4. All other para- 
meters are the same. Before using RU, FTN, the operator 
must place the source program in the input device, or, if 
input is from LS Tracks, specify the file location with an 
LS operator request. If planning to relocate and run, the 
operator allocates LG tracks with an LG operator request. 



Purpose: 

To schedule the FORTRAN compiler for operation. 

Format: 

RU,FTN,mpu^, list, output, lines, 99 

or 

RU, FTN4,input, list, output, lines, 99 

Where: 

input = Logical unit number" of input device. Use 2 
for source file input from the disc (set to 5 if 
not given). 

list = Logical unit number of list device (set to 6 if 
not given). 

output = Logical unit number of output device (set to 
4 if not given). 

lines = Lines/page on listing (set to 56 if not given). 

^9 ~ The LG parameter (LG command required 
first). If present, the object program is stored 
in the LG tracks for later loading. Any 
punching requested still occurs. The 99 may 
occur anywhere in the parameter list, but 
terminates the list. 

Example: 

RU,FTN < is equivalent to RU,FTN,5, 6,4,56 > 
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MESSAGES TO OPERATOR 

More than one source tape can be compiled into one FOR- 
TRAN program by leaving off the SEND statement on all 
but the last source tape. When the end of each source tape 
is encountered (end-of-tape or EOT condition), RTE Driver 
DVROO can interpret it in two ways. An EOT can set the 
tape reader down (make it inactive), or not set it down. The 
action depends on how DVROO subchannels were con- 
figured during generation. In any case, an EOT does not 
suspend the FORTRAN compiler. Therefore, it is recom- 
mended that when compiling multiple tapes, DVROO be 
configured to set the tape reader down on EOT (see the LU 
command). For more information refer to the DVROO 
Manual (HP Part No. 29029-95001). 

If an EOT causes the tape reader to be set down, the RTE 
system will output a message to the operator: 

I/O ET L #lu E #eqt S #sub 

The operator must place the next source tape into the tape 
reader and set the tape reader up with the UP operator 
command. 

\J?,eqt 

If an EOT does not cause the tape reader to be set down, 
the RTE-III system does not output any message and the 
compiler is not suspended. 

At the end of the compilation (when the compiler detects 
the SEND statement), the following message is printed. 

$END,FTN 

Two I/O error messages may be generated by the system 
when FTN attempts to write on the LG tracks (FTN is 
aboried). 

IO06 
IO09 

IO06 means that the LG tracks were not defined by an 
LG operator request, and IO09 means that the LG tracks 
overflowed. The operator must define more LG tracks 
with LG and start compilation over again. 



The compiler terminates abnormally if: 

a. No source file is declared by LS, although logi- 
cal unit 2 is given for input. Compiler error E-0019 



(FTN2), or ERROR 05 (FTN4) is printed on the list 
device. 

b. The symbol table overflows. Compiler error 
E-0014 (FTN2), or ERROR 03 (FTN4) is printed on 
the list device. SEND, FTN does not appear after the 
error message using FTN2, but does appear when us- 
ing FTN4. 

FORTRAN FORMAT 

The RTE FORTRAN language is similar to the regular HP 
FORTRAN language. The differences are described in the 
next pages. RTE FORTRAN has additional capabilities, 
using EXEC calls. Read Section III for complete details on 
the EXEC calls. 

FORTRAN CONTROL STATEMENT 



Purpose: 

To define the output to be produced by the 
FORTRAN compiler. 



Format: 



Where: 



FTN,B,L,A 



B = Punched binary tape (B not present does not 
affect binary output to load-and-go tracks). 

L = List output. 

A = Assembly listing. 

Besides the standard options shown above, two 
additional compiler options, T and n, are available. 

T 

Lists the symbol table for each program in the 
compilation. If a "u" follows the address of a 
variable, that variable is undefined (the program does 
not assign a value to it). The A option includes this T 
option. 



n is a decimal digit (1 through 9) which specifies an 
error routine. The user must supply an error routine, 
ERR/T. If this option does. not appear, the standard 
library error routine, ERRO, is used. The error 
routine is called when an error occurs in ALOG, 
SQRT, .RTOR, SIN, COS, .RTOI, EXP, .ITOI or 
TAN. 
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PROGRAM STATEMENT 



Purpose: 

The program statement, which must be the first 
statement in a FORTRAN source program, includes 
optional parameters defining the program type, 
priority, and time values. 

Format: 

PROGRAM name, (type,pri, res, mult, hr, min, sec, msec) 

Where: 

name is the name of the program (and its entry point). 

type is the program type (set to 3 for main 
program, or 7 for subroutines, if not given). 



= 

1 = 

2 = 

3 = 

4 = 

5 = 

6 = 

7 = 



pri 



res 



System Program 

Real-Time Memory-Resident 

Real-Time Disc-Resident 

Background Disc-Resident 

Not used 

Background Segment 

Illegal 

Library, utility 

If program is a main, it is deleted from 

the system 



or 



If is a subroutine, then it is used to 
satisfy any external references during 
generation. However, it is not loaded 
in the relocatable library area of the 
disc. 

The primary type may be expanded in 
some cases by adding 8, 16 or 24 to 
the number. These expanded types 
allow such features as access to real- 
time common by background programs 
arid access to SSGA. See Appendix I 
for a list of expanded program types. 



is the priority (1- 
not given). 



-32767, set to 99 if 



is the resolution code. 



mult is the execution multiple. 
hr is hours. 

is minutes. 

is seconds. 
msec is tens of milliseconds. 



mm 



sec 



COMMENTS 

The parameters type through msec must appear in the order 
shown. And even though the parameters are optional, if any 
one parameter is given, those preceding it must appear also. 
For example: 

PROGRAMrtame(,90) 

is illegal and will be rejected by the system. The only 
method of legally defaulting the parameters is shown be- 
low: 

PROGRAM name 
PROGRAM name(3,90) 

All parameters are set to if not specified with the fol- 
lowing two exceptions: 



a. 



b. 



The priority parameter pri is set to 99, the 
lowest priority recognized by RTE FOR- 
TRAN. 

The program type parameter type is set to 3 
for a main program, or 7 for subroutines. Type 
6 is illegal. 
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DATASTATEIVIENT 



EXTERNAL STATEMENT 



Purpose: 

The DATA statement sets initial values for variables 
and array elements. 



Format: 

Where: 
k 

d 



DATA A: i/c? 1/^2/^2/, • • • . W 



is a list of variables and array elements 
separated by commas. 

is a list of constants (optionally signed) 
which can be immediately preceded by an 
integer constant (followed by an asterisk) 
identifying the number of times the constant 
is to be repeated. 

is a separation, and is used to bind each 
constant list. 



The elements of dj are serially assigned to the 
elements of kj, therefore, kj and dj must correspond 
one-to-one. If a list contains more than one entry, the 
entries must be separated by commas. 

Elements of kj may not be from COMMON. 

Arrays must be defined (i.e., DIMENSION) before 
the DATA statements in which they appear. 



Example: 

DIMENSION A(3), 1(2) 



DATA A(l), A(2), A(3)/l .0,2.0,3.0/ , 
1(1), I (2)/ 2*1/ 



Purpose: 

With the EXTERNAL statement, subroutines and 
functions can be passed as parameters in a subroutine 
or function call. For example, the routine XYZ can 
be passed to a subroutine if XYZ is previously 
declared EXTERNAL. Each program may declare up 
to five EXTERNAL routines. 



Format: 



Where: 



EXTERNALvi, V2.- • • ,Vs 



Vj is the entry point of a function, subroutine, 

or library program, which exists externally. 



Example : 



FUNCTION RMX (X,Y,A,B) 

RMX=X (A) * Y (B) 

END 

PROGRAM ABCDE 

EXTERNAL XYZ, FLl 

Z=Q-RMX (XYZ,FL1, 3.56,4.75) 

END 

NOTE 

If a library routine, such as SIN, is 
used as an EXTERNAL, the com- 
piler changes the first letter of the 
entry point to "%." Special versions 
of the library routines exist with 
the first character changed to "%." 
See RTE Relocatable Library, Part 6 
in this section. 
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PAUSE & STOP STATEMENTS 



ERRO LIBRARY ROUTINE 



Purpose: 






PAUSE provides a temporary program halt and the 
program to be suspended. 


Format (as 


displayed): 

name: PAUSE oct numb 




Where: 






name 


is the program name. 




Oct numb 


is the octal number given in the PAUSE. 




Note that the 'B' octal designator suffix 




is not required. 




To restart the program, use a GO operator re 
(See Section II, GO.) 


quest. 


Purpose: 






STOP causes the program to be terminated. 




Format (as 


displayed): 

name: STOP oct numb 




Where: 






name 


is the program name. 




Oct numb 


is the octal number given in STOP 


Note 




that the 'B' octal designator suffix 


is not 




required. 





Purpose: 

Prints the following message whenever an error occurs 
in a library routine. 



Format: 

Where: 
name 
id 
type 



name: id type 

is the program name, 
is the routine identifier, 
is the error type. 



COMMENTS 

The compiler generates calls to ERRO automatically. 

If the FORTRAN control statement includes an n option, 
the call will be to ERR/7,a routine which the user must 
supply. 

Read the appropriate FORTRAN manual for the meaning 
of error codes. 
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PART 2 
RTE ALGOL 



The RTE ALGOL compiler is a segmented program that 
accepts source programs written according to regular HP 
ALGOL with some additions and changes. 



ALGOL REFERENCE 

For a complete description of the HP ALGOL language, 
including error messages, read the HP ALGOL Reference 
Manual (Part No. 02 11 6-9072). 

COMPILER OPERATION 

An RU,ALGOL operator request schedules the RTE 
ALGOL compiler for execution. Before using RU,ALGOL, 
the operator must place the source program in the input 
device, or, if input is from LS Tracks, specify the file 
location with an LS operator request. If planning to relocate 
and run, the operator allocates LG tracks with an LG 
operator request. 



RU,ALGOL 



Purpose: 

To schedule the ALGOL compiler for operation. 

Format: 

RU,ALGOL, input, list, output, lines, 99 

Where: 

input = Logical unit number of input device. Use 2 
for source file input from the disc. (Set to 5 
if not given). 

list = Logical unit number of list device (set to 6 if 
not given). 

output = Logical unit number of output device (set to 
4 if not given). 

lines = Lines/page on listing (set to 56 if not given). 

99 = The LG parameter (LG command required 
first). If present, the object program is 
stored in the LG tracks for later loading. 
Any punching requested still occurs. The 
99 may occur anywhere in the parameter 
list, but terminates the Hst. 

Example: 

RU,ALGOL < is equivalent to RU,ALGOL,5,6,4,56 > 



MESSAGES TO OPERATOR 

A single ALGOL program can be made up of several source 
tapes. When the end of each source tape is encountered 
(end-of-tape or EOT condition), RTE Driver DVROO can 
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interpret it in two ways. An EOT can set the tape reader 
down (make it inactive), or not set it down. The action 
depends on how DVROO subchannels were configured 
during generation. In any case, an EOT does not suspend 
the ALGOL compiler. Therefore, it is recommended that 
when compiling multiple tapes, DVROO be configured to 
set the tape reader down on EOT (see the LU command). 
For more information refer to the DVROO Manual (HP 
Part No. 29029-95001). 



If an EOT causes the tape reader to be set down, the RTE 
system will output a message to the operator: 

I/O ET L #lu E #eqt S #sub 

The operator must place the next source tape into the tape 
reader and set the tape reader up with the UP operator 
command. 

U?,eqt 



If an EOT does not cause the tape reader to be set down, 
the RTE-III system does not output any message and the 
compiler is not suspended. 

At the end of completion (when the compiler detects the 
ENDS statement), the following message is printed. 

SEND ALGOL 

If source input is indicated to be from the disc (by input=2 
in the ON control statement), and the source pointer is not 
set, the diagnostic 

NO SOURCE 

is output to the system teleprinter and the compilation 
ceases. 



At the end of a program, a program-termination request is 
made to the Executive. No message is printed. 

In case of a PAUSE statement, the following message is 
printed: 

name : PAUSE xxxx 

Where 

name = the program name. 

xxxx = number which has no significance. 

Execution is then suspended. To restart the program, type 

GO, name 

See the GO operator command in Section II for a definition 
of the parameters. 

ALGOL FORMAT 

The first statement of an RTE ALGOL program is the HPAL 
control statement. The control statement does not use the 
symbol S (sense switch control). Also, after the NAM record- 
name, additional parameters may be specified. 



Two I/O error messages may be generated by the system 
when ALGOL attempts to write on the LG tracks 
(ALGOL is aborted). 

IO06 
IO09 

IO06 means that the LG tracks were not defined by an LG 
operator request, and IO09 means that the LG tracks over- 
flowed. The operator must define more LG tracks with LG 
and start compilation over again. 
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ALGOL CONTROL STATEMENT 



Purpose: 




To define the output to be produced by the ALGOL 


compiler. 




Format: 






HPAL [,L,A,B,P] , 


"name"[, numb, type, pri, res, mult, hr, min, sec, msec] 


Where: 




L 


Produce source program hsting. 


A 


Produce object code Hsting. 


B 


Punch binary tape. B not present does 




not affect binary output to load-and-go 




tracks. 


P 


A procedure only is to be compiled. 


"name" = 


Program name. 


numb = 


A digit from 1 through 9 specifying the 




error-routine name. A library routine, 




ERRnumb with numb = 1-9 must be 




supplied by the user. If this option is not 




specified, the error-routine name is 




ERRO. The error routine is called when 




an error occurs in the following routines: 




ALOG, SQRT, .RTOR, SIN, COS, .RTOI, 




EXP, .ITOI, TAN. 


type 


The program type (set to 3 for main pro- 




gram, or 7 for subroutines, if not given). 


= 


System Program 


1 = 


Real-Time Core-Resident 


2 = 


Real-Time Disc-Resident 


3 = 


Background Disc-Resident 


4 = 


Background Core-Resident 


5 = 


Background Segment 


6 = 


Illegal 


7 = 


Library, utility 


8 = 


If program is a main, it is deleted from the 




system 




- or - 


8 = 


If it is a subroutine, then it is used to 




satisfy any external references during 




generation. However, it Is not loaded 




in the relocatable library area of the disc. 





9 = 


Foreground core-resident, uses back- 
ground common 




10 = 


Foreground disc-resident, uses back- 
ground common 




11 = 


Background disc-resident, uses fore- 
ground common 




12 = 


Background core-resident, uses fore- 
ground common 




13 = 


Background segment, uses foreground 
common 




14 = 


Illegal 


pri 


= 


Priority. 


res 


= 


Resolution code (0-4). 


mult 


= 


Execution multiple (0-999). 


hr 


= 


Hours (0-23). 


min 


= 


Minutes (0-59). 


sec 


= 


Seconds (0-59). 


msec 


= 


Tens of milliseconds (0-99). 



COMMENTS 

Note that the program-name specified in "name" must be 
enclosed in quotation marks, must be a legitimate iden- 
tifier, and must not contain blanks. 

If no symbols are specified (L through P), and if 
load-and-go is not specified in the RU,ALGOL control 
statement, the program is compiled but does not produce 
output other than diagnostic messages. 

If there is an error in the control statement, the diagnostic 
"HPAL??" is printed on the system console. The compiler 
then returns control to the system. 

The parameters numb through msec must appear in the 
order shown. And even though the parameters are optional, 
if any one paramenter is given, those preceding it must 
appear also. For example: 



name 



90 



is illegal and will be rejected by the system. The only 
method of legally defaulting the parameters is shown be- 
low: 



name 
or 
name, 3, 3, 90 
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All parameters are set to if not specified with the fol- 
lowing two exceptions. 

a. The priority parameter pn is set to 99. 



b. The program type parameter type is set to 3 if 
both type and P are not specified, or 7 if type is not 
specified and P is specified. 
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PART 3 
RTE Assembler 



The RTE Assembler is a segmented program that consists of 
a main program and segments, and resides in the protected 
area of the disc. 



RU,ASMB 



RTE Assembler Language, a machine-oriented program- 
ming language, is very similar to regular HP Extended 
Assembler Language. Source programs, accepted from 
either an input device or disc LS tracks, are translated 
into absolute or relocatable object programs. Absolute 
code is written in binary records suitable for execution 
outside of RTE-IIL ASMB can store relocatable code in the 
LG area of the disc for on-line execution, as well as writing 
it to an output device. The RTE Relocating Loader accepts 
Assembler Language relocatable object programs. 



The source tape passes through the input device only once, 
unless there is insufficient disc storage space. In this case, 
two passes are required. (See next page Messages To Opera- 
tor.) 

ASSEMBLER REFERENCE 

For a complete description of the HP Assembler language, 
read the Assembler Reference Manual (HP Part No. 
92060-90005). 

ASSEMBLER OPERATION 

An RU operator request schedules the RTE Assembler for 
execution. Before using RU,ASMB, the operator must 
place the source program in the input device, or if the in- 
put is from LS Tracks, specify the file location with an LS 
operator request. If planning to relocate and run, the 
operator must allocate LG tracks with an LG operator 
request. The format for scheduling the Assembler is: 



Purpose: 

To schedule the Assembler for operation. 

Format: 

RU,ASMB, input, list, output, lines, 99 

Where: 

input = Logical unit number of input device. Use 2 
for source file input from the disc. (Set to 5 
if not given.) 

list = Logical unit number of list device (set to 6 if 
not given). 

ou^pM^ = Logical unit number of output device (set to 
4 if not given). 

lines = Lines/page on listing (set to 56 if not given). 

99 = LG parameter (LG command required first). 
If present, the object program is stored on 
the disc for loading, and any punching re- 
quested still occurs. The 99 may occur any- 
where in the parameter Hst, but terminates 
the hst. 

Example: 
RU,ASMB < is equivalent to RU,ASMB,5,6,4,56 > 



MESSAGES TO OPERATOR 

When a paper tape is being input through the tape reader, 
RTE Driver DVROO can interpret and end-of-tape (EOT) in 
two ways. An EOT can set the tape reader down (make it 
inactive), or not set it down. The action depends on how 
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DVROO subchannels were configured during generation. In 
any case, an EOT does not suspend the Assembler. There- 
fore, it is recommended that when assembling multiple 
tapes, DVROO be configured to set the tape reader down on 
EOT (see the LU command). For more information refer to 
the DVROO Manual (HP Part No. 29029-95001). 

If an EOT causes the tape reader to be set down, the RTE 
system will output a message to the operator: 

I/O ET L #lu E #eqt S #sub 

The operator must up the tape reader with the UP operator 
command. 

UP, eqt 

If an EOT does not cause the tape reader to be set down, 
the RTE-III System does not output any message and the 
Assembler is not suspended. 

At the end of assembly, the following message is printed: 

SEND ASMB 

If another pass of the source program is required, the fol- 
lowing message appears at the end of pass one. 

SEND ASMB PASS 

The operator must replace the program in the input device 
and type: 

GO, ASMB 

If an error is found in the Assembler control statement, the 
following message appears: 

SEND ASMB CS 

The current assembly aborts. 

If an end-of-file condition occurs before an END statement 
is found (LS file only), the console signals: 

SEND ASMB XEND 

The current assembly aborts. 

If source input for logical unit 2 (disc) is requested, but no 
file has been declared (see LS, Section II), the console 
signals: 

SEND ASMB NPRG 



The current assembly aborts. 

RTE-III generates two messages when ASMB attempts to 
write on the LG tracks (ASMB is aborted). 

IO06 
IO09 

IO06 means that the LG tracks were not defined by an LG 
operator request, and IO09 means that the LG traciks have 
overflowed. The operator must define more LG tracks with 
LG and start the assembly over again. 



The next message is associated with each error diagnostic 
printed during pass 1 . 

# tape numb 

tape numb is the "tape" number where the error (reported 
on the next line of the listing) occurred. A program may 
consist of more than one tape. The tape counter starts with 
one and increments whenever an end-of-tape condition oc- 
curs (paper tape) or a blank card is encountered or a zero 
length record is read from the disc. When the counter incre- 
ments, the numbering of source statements starts over at 
one. 

Each error diagnostic printed during pass 2 of the assembly 
is associated with a different message: 

PG page numb 

page numb is the page number (in the listing) of the pre- 
vious error diagnostic. 

PG 000 is associated with the first error in the program. 

These messages occur on a separate line, above each error 
diagnostic in the listing. 

ASSEMBLER CONTROL STATEMENT 

The control statement has the same form as that of regular 
Assembler language; and although only relocatable code 
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can be run under RTE, the RTE Assembler accepts and 
assembles absolute code. Absolute code is never stored in 
the LG tracks. To get absolute code, the control 
statement must include an "A." The "R", however, is not 
required for relocatable code. An "X" causes the assembler 
to generate non-extended arithmetic unit (non-EAU) code. 
B is required to punch a binary tape. B not present does not 
affect binary output to LG tracks. 

The memory protect feature, which protects the resident 
executive from alteration (except in the case of privileged 
hbrary routines), interrupts the execution of a user program 
under these conditions: 

a. Any operation that would modify the pro- 
tected area or jump into it. 

b. Any I/O instruction, except those referencing 
the switch register or overflow, 

c. Any halt instruction. 

When an interrupt occurs, memory protect gives control to 
the system which checks to see if the interrupt was from a 
legal system call. If not, the user program is either suspend- 
ed or aborted (depending on bit 15). 



NAM STATEMENT 



Purpose: 

The NAM statement, which must be the first 
statement in an Assembler source program, includes 
optional parameters defining the program type, 
priority, and time values. 

Format: 

NAM name, type, pri, res, mult, hr, min, sec, msec id 

Where: 

name is the name of the program. 

type is the program type (set to if not given): 

= System program 

1 = Real-time core-resident 

2 = Real-time disc-resident 

3 = Background disc-resident 

4 = Background core-resident 

5 = Background segment 

6 = Library (re-entrant or privileged) 
7= Library, utility 

8 = If program is a main, it is deleted from 
the system 

— or — 

8 = If program is a subroutine, then it is 
used to satisfy any external references 
during generation. However, it is not 
loaded in the relocatable library area 
of the disc. 

The primary type may be expanded in 
some cases by adding 8, 16, or 24 to 
the number. These expanded types 
allow such features as access to real- 
time common by background programs 
and access to SSGA. See Appendix I 
for a list of expanded program types. 
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pri 


is the priority (1 to 32767, 


set to 99 if not 




given). 


res 


is the resolution code > 




mult 
hr 


is the execution multiple, 
is hours. 


(Time values, 
set to if not 


min 


is minutes. 


, given. See 
Section II, IT, 


sec 


is seconds. 


for meaning) 


msec 


is tens of milUseconds. 




comments field-separated 

from parameters by a space. 
These parameters are optional; but if any one 
parameter is given, those preceding it must appear 
also. 



COMMENTS 

The parameters of the NAM statement, beginning with type 
and ending vi/ith msec, are separated by commas. A blank 
space within the parameter field will terminate that field 
and cause the Assembler to recognize the next entry as the 
comment field (/of). The first parameter must be separated 
from the program name by a comma. The parameters are 
optional, but to specify any particular parameter, those 
preceding it must also be specified. 

The comment field (id) can be a maximum of 73 characters 
due to the restriction of the source statement size. The 
source statement will be truncated after column 80. 

The comment field in the NAM statement will be included 
as ASCII in the relocatable binary object code. This means 
that when the program is relocated with the RTE loader, 
the comments field will be printed out as part of the NAM 
statement. 
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PART 4 
RTE RELOCATING LOADER 



The RTE-III On-line Relocating Loader, LOADR, accepts 
relocatable code from an input device such as paper tape, 
magnetic tape, and so forth, or from LG tracks (see LG 
operator request, Section II) filled by the RTE Assembler, 
RTE FORTRAN, or RTE ALGOL. LOADR provides for 
linking the relocatable program file produced by the Assem- 
bler or the compilers together with one or more library files. 

The resultant program may be relocated (loaded) as a 
background program; or it may be relocated as a back- 
ground program with the DEBUG library routiiie ap- 
pended to it; or it may be relocated as a real-time disc- • 
resident program for subsequent action. In addition, 
LOADR may be used to hst program names and blank 
ID segments, purge permanent programs from the system, 
add permanent programs to the system, or replace perm- 
anent programs in the system. 

The RTE-III Relocating Loader has the following features: 

• Can be operated under control of the File Manager in 
batch mode. 

• LOADR is swappable and can be operated in either 
real-time or background disc-resident areas. 

• Allows programs which declare COMMON to refer- 
ence either a system or reverse common area (shared 
with other programs) or a local common area (not 
shared with other programs). 

• Can relocate referenced library routines which are on 
LG tracks. 

• Can force the relocation of subroutines which have 
not been referenced by a previously relocated module. 
For example, you can force the relocation of your 
own version of a subroutine that already exists in the 
system library (see library parameter, GO,LOADR 
command). 

• Allows a program to be permanently added to the 
system (i.e., only the loader can be used to purge a 



permanent program; the OF,name,S command will 
not remove a permanent program from the system). 

• Allows a program to be temporarily loaded into 
either the real-time or background area. 

• Allows a program to reference absolute and code 
replacement type ENT records (see Section VI). 

• Uses system area disc tracks that have been vacated 
by deleted programs. 

• Uses a short ID segment (when available; see 
Appendix A) when loading a background program 
segment. In addition, the loader does not restrict 
the arrangement of subroutines following segments 
(e.g., if a subroutine is shared by two segments, only 
one copy of it is necessary on the LG tracks). 

Options are available as parameters to the ON,LOADR 
statement which permit you to specify: 

1) the logical unit number of the input device. 

2) the logical unit number of the Hst device. 

3) an operation code which includes a Subsystem Global 
Area (SSGA) flag together with common type and 
loader operation indicators. 

4) a program format code which includes program mem- 
ory size requirements, partition assignment, and a 
program structure indicator. 

5) listing characteristics. 

A detailed description of the ON,LOADR statement is given 
under Loader Operation in this section. 

At load time, it is not necessary to know the real address of 
the partition in which the program will run because each 
partition appears to be within the first 32K words of mem- 
ory. The location at which a program area appears to begin 
is a logical address. The program is relocated with respect to 
this logical address. Logical memory address space configura- 
tions are illustrated in Section VI, Figure 6-2. 
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You have more address space available for your program if 
it does not declare COMMON. If COMMON is not declared, 
the program is relocated (loaded) to begin after the system 
resident library. If COMMON is declared, the common area 
begins after the system resident library and is followed by 
the program. 

LG TRACK AREA 

The RTE system provides facilities for the assembly or 
compilation, relocation, and scheduling for execution of a 
user program without intervening paper tapes. To accom- 
plish this, the assembler or compiler accepts source state- 
ments from which it generates relocatable object code. The 
relocatable code may be stored on disc in predefined LG 
tracks (see LG Operator Request, Section II). Then, separate 
operator requests initiate relocation (e.g., RU,LOADR) and 
schedule execution (e.g., ON, or RV, program name). 



Two rules should be remembered when using the LG track 
area: 

a. Do not reset the LG track area using the LG 
command if the LG track area was just used for a 
forced relocation and additional Ubrary routines re- 
main to be relocated. To do so would result in the 
loss of the additional routines to the loader. 

b. When the initial input is from the LG track area, 
the input option parameter of the GO,LOADR com- 
mand is set to 99 to indicate that the LG tracks have 
been reset with new data moved into them. Setting 
the input option to 2 implies that the LG tracks have 
not been reset and additional data has been added to 
them. 



When using the loader, the programmer can structure the 
LG track area with a single main program and subroutines, 
or with a main program and segments. For relocating a main 
program with segments from the LG track area, some con- 
straints are imposed by LOADR. These constraints are: 



a. Once the LG track area has been scanned and 
relocated, there should be no undefined external 
references in the main program. If there are, they will 
be listed after the last segment is relocated but they 
cannot be satisfied. 

b. A segment cannot satisfy any external refere- 
nces made by another segment. However, the main 
program can satisfy segment external references, and 
segments can satisfy main program external references. 



When the loader terminates either with the message 
/LOADER: SEND, or /LOADR ABORTED, the LG 
track area is cleared. If the loader terminates in some 
other manner, the LG track area is not cleared. 

PROGRAM RELOCATION 

During loading, programs are relocated to start at the 
beginning of the disc-resident program area of logical 
memory. If COMMON is declared, the program wih be 
preceded by the common area. The logical address of 
the program location is always at a page boundary and 
the first two words of the program location are allocated 
for saving the contents of the X- and Y-registers v/hen- 
ever the program is suspended. 

Once relocated, the program is linked to external refer- 
ences such as EXEC, the resident hbrary, or the relocat- 
able library. Any segments will overlay the memory area 
immediately following the main program and its sub- 
routines. 

LOADR stores the absolute version of the program, its 
subroutines, and linkages on a disc track or a group of 
contiguous disc tracks; it then assigns the disc tracks to 
the system (that is, they are not available as scratch or 
data tracks to programs). LOADR then builds or updates 
the ID segment assigned to the program. The program 
together with its subroutines and its largest segment may 
be as large as the largest partition of the same type. If a 
program is assigned to a partition, it must not be larger 
than the partition or an error, LI 7, results (see LOADR 
Error Messages). Common may be allocated in one of 
several areas according to the needs of the programmer 
(see the optional parameter list for theRU,LOADR 
request). 

PROGRAM DISPOSITION 

Regardless of the program type recorded in the program's 
NAM record, the third parameter (opcode) of the 
RU,LOADR request determines the program disposition. 
This parameter's default (zero) results in a background 
temporary program. Other parameter values result in a 
background temporary program with the DEBUG library 
subroutine appended, a real-time temporary program, a 
real-time or background permanent program addition, or 
a real-time or background permanent program replacement. 

ON-LINE MODIFICATION 

Using the loader, the operator can permanently modify 
the set of disc-resident user programs in a configured 
RTE-III system. The loader adds new disc-resident real- 
time or background programs, and replaces disc-resident 
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programs with updated versions that have the same name. 
When a program is being replaced it must be dormant, not 
in the time list, and have a zero point of suspension. The 
OF Operator Request deletes those disc-resident programs 
loaded temporarily into the system by the loader. The OF 
request cannot delete program segments that were perma- 
nently added on-line or stored during generation. 

When the system is generated, RTGEN, the system genera- 
tor, stores disc-resident programs on the disc in an absolute, 
packed format. Each main program is identified and lo- 
cated by a 28-word ID segment. The ID segments ^are stored 
in the ID segment area of the system on the disc and 
brought into main memory when the system is started up. 
For disc-resident programs, the program's disc location as 
well as its main memory and base page addresses are kept in 
the ID segment. When a main program and segments are 
loaded, the segments are identified and located by a 9-word 
short ID segment. See Appendix A for ID segment format. 

RTGEN can create a number of blank 28-word and 9-word 
ID segments so that the loader can add new programs and 
segments to the permanent system later. The addition or 
replacement of a program involves the conversion of relocat- 
able programs into an absolute unit, finding space on the 
disc to store it, and and recording information in the ID seg- 
ment. The loader always attempts to use the short ID seg- 
ment for identifying a program segment. However, if a 
short ID segment is not available, a regular 28-word ID 
segment is used. 

In replacing, the new program may overlay the old pro- 
gram's disc space only if the length of the new program 
plus base page linkages does not exceed the disc space 
formerly occupied by the old program. A track or group 
of tracks is allocated for program storage if adding a pro- 
gram, or if space requirements of a replacement program 
exceed those of the old. These newly allocated tracks are 
software-protected, but not hardware-protected. 

Memory-resident programs cannot be replaced in the sys- 
tem because the length of the program and linkage area 
is not kept in the ID segment for these programs, nor can 
programs be added. 



If a user supplied routine is to be referenced by a pro- 
gram, and a memory-resident subroutine of the same 
name already exists in the system, then the user sup- 
phed routine must be loaded before any reference is made 
to it. Conversely, if a system relocatable library routine 
has to be replaced, the user supplied routine can be force 
loaded even after it has been referenced. 



When performing an on-line modification, the disc hard- 
ware protect must be physically disabled prior to the load- 
ing (and then enabled afterwards) unless the protection 
is always kept disabled. RTE provides additonal software 
protection for any tracks containing system programs or 
user programs. 

LIMITATIONS 

Several limitations may prohibit the final addition or re- 
placement of disc-resident programs: 

a. System or reverse common is requested but 
the program's common length exceeds that of the 
common area. 

Local common is requested and COMMON is 
not declared by the first relocatable module en- 
countered by the loader, even though the module is 
a dummy module which contains no executable code. 

b. The base page linkages exceed the correspond- 
ing linkage area for disc-resident programs estab- 
hshed by the system during generation. 

c. The length of the absolute program unit ex- 
ceeds the area available. 

d. Disc space is not available to store the program. 

e. A blank ID segment is not available for adding 
a program. (A program previously loaded can be 
deleted to create a blank ID segment.) 

SEGMENTED BACKGROUND PROGRAMS 

Segmented programs can be added and replaced in any order 
as long as the main program is always entered first. Per- 
manent addition of main segment programs will not nec- 
essarily result in the main and segments being stored on 
contiguous tracks. 

When replacing segmented programs that were incorporated 
into the system at generation time, the operator must re- 
place every segment with a new segment having the same 
name, or remove the original segment permanently from 
the system. Additonal segments, however, may be added in 
a replacement and any segments left over (from the old 
program) as a result of replacement may be deleted using 
the loader. 

NEW PROGRAM ADDITION 

When a new program is added, it is stored on a complete 
disc track or several contiguous tracks. A blank ID segment 
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is allocated to record the program's memory and disc bound- 
aries, name, type, priority, assigned partition, and time 
values. The loader attempts to use available disc space in the 
system before allocating new full tracks. If new tracks must 
be allocated, they are assigned to the system and are soft- 
ware- protected. 

PROGRAM REPLACEMENT 

In a replacement, the new program uses the ID segment of 
the old program (both programs must have the same name). 
The new program is generated onto temporary tracks, and 
then, if it can fit in the old area, or within another area 
gained by deleting a program incorporated during gener- 
ation, it is transferred to that area. If not, the temporary 
tracks attain system track status and if a blank ID segment 
is available, the old tracks are assigned to it for later use by 
another program. If a blank ID segment is not available, 
the old tracks are lost. 



PROGRAM DELETION 

A temporary program is deleted from the system with the 
0F,name,8 command. A permanent program (i.e., a program 
loaded during generation, or on-line with the loader as a 
permanent addition or replacement load) is deleted with the 
loader. When using the loader to delete a permanent program, 
the opcode parameter is set to 4. This blanks the program's 
ID segment making it available for loading another program. 
The tracks containing the program are released, unless they 
are system tracks. If the program had been saved through 
the File Manager on FMP tracks, those tracks are not re- 
leased to the system but remain as FMP tracks. 



COMMON ALLOCATIONS 

There are three options you can specify when allocating 
common area for a program. 

SYSTEM COMMON. This implies a background program 
with common in the background system common area, or 
a real-time program with common in the real-time common 
area. 

LOCAL COMMON. Common area for a background pro- 
gram is established at the beginning of the background pro- 
gram's area, or for a real-time program, at the beginning of 
the real-time program's area. The common area will be 
swapped together with the program. 

REVERSE COMMON. This implies a background program 
with its common in the real-time common area. Conversely, 
a real-time program can reference and use the background 
system common area. 



LOADER OPERATION 

The operator schedules the loader for execution with the 
ON operator command. 

RU,LOADR 



Purpose: 

To relocate a program so the program can be 
scheduled by an ON or RU operator request. 

Format: 

RU,LO ADR, input, list,opcode,fmt, listing 



Where: 
input 

list 
opcode 



Parameter 1 , — logical unit number of 
input device. If set to 99, the LG tracks 
are used, but 99 does not terminate the 
parameter hst (default = 5). 

Parameter 2 — logical unit number of 
list device (default = 6). 

Parameter 3 — SSGA Flag/Common 
Type/Operation Code: A three digit 
code (decimal) indicating Subsystem 
Global Area Flag, Type of Common, 
and Loader Operation to perform, as 
follows: 

abc 

where, 



Subsystem 


a = No SSGA (default) 


Global Area 


= 1 Use SSGA 


Flag 




Type of 


Z? =0 No Common or 


Common 


use local Common 




if any is de- 




clared (default) 




= 1 System Common 




= 3 Reverse Common 


Loader 


c = Background Tem- 


Operation 


orary (default) 




= 1 Background 




(DEBUG ap- 




pended) 




= 2 On-line Edit 




= 3 List 




= 4 Purge 




= 5 Real-time Tem- 




porary 



4-20 



RTE Relocating Loader 



fmt 



listing 





= 6 Real-time Re- 




placement 




= 7 Real-time Addi- 




tion 




= 8 Background Re- 




placement 




= 9 Background 




Addition 


Parameter 4 - Size/Partition/Structure 


Control: 


A five digit code (decimal) in- 


dicating memory size and override require- 


ments, partition assignment, and pro- 


gram structure as follows: 


xxyyz 




where. 




Size 


XX = 00 Use program size 




(default) 




01-32 Required size in 




pages 


Partition 


yy = 00 None assigned 




(default) 




= 01-64 Assigned parti- 




tion number 


Structure 


z = Main program 




(default) 




= 1 Main program 




plus segments 



= Parameter 5 — Listing parameter (only 
when input = 99). A one digit code 

Where: 

= List program name, bounds, and 

entry points. 

1 = List only entry points. 

2 = List only program name and bounds. 

3 = Omit program name, bounds, and 

list of entry points from hsting. 



COMMENTS 

If a track allocation cannot be made, the message WAITING 
FOR DISC SPACE is printed. The loader repeats the disc re- 
quest and is suspended until space becomes available. 

Fohowing the relocation of a program which has its external 
references satisfied, the loader terminates with the following 
messages: 

/LOADR: mm e READY 
/LOADER: $END 



Where name is the main program name. The loader termi- 
nates and the program is ready to run. 

opcode. PARAMETER (PARAMETER 3) 

This parameter is specified as a decimal value of three digits. 
The first (left) digit determines whether or not the program 
uses the Subsystem Global Area (SSGA). The second digit 
determines whether or not common is to be used and, if 
common is used, the type of common. The third digit de- 
termines the loader operation to be performed. Setting the 
loader operation value to 1 causes the DEBUG utihty 
routine to be appended to each main program and segment. 
The loader sets the primary entry point of each main pro- 
gram and segment to DEBUG, rather than to the user 
program. When the program is run, DEBUG takes control 
of program execution and requests instructions from the 
keyboard. (See RTE DEBUG LIBRARY SUBROUTINE 
for legal commands.) 

Setting the loader operation value to 2 initiates the loader 
for an on-line edit which requires additional information 
through the GO,LOADR request. See Loader Operation 
(On-line Edit) for addition information. 

Setting the loader operation value to 3 causes a listing of all 
program names and blank ID segments to be printed. For 
each ID segment in the system the following format is used: 

name, type, priority, partition 

name is the program name 

type is the program type: 

1 — Real-time Memory-resident. 

2 — Real-time Disc-resident. 

3 — Background Disc-resident. 

4 — Background Memory-resident. 

5 — Background Segment. 

priority is the program priority, from 1 to 32161 . 

partition is the partition number, from 1 to 64. This field 
appears only if the program is assigned to a 
specific partition. 

Each blank ID segment available for use by the loader is 
noted by the line: 

<LONG BLANK ID > 



<SHORT BLANK ID > 



The loader terminates after the hst is complete. 
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Setting the loader operation value to 4 initiates the purge of 
a permanent program. Using this option, the input and list 
parameters automatically default to 1 . The loader's response 
to this option is: 

/LOADR: PNAME? 

Enter the program's name on the keyboard input device and 
it will be permanently removed from the system. To abort 
the command (and LOADR) enter /A. 

Setting opcode = 5-9 allov^s the loader to run in Batch 
mode without operator intervention. 

fmt PARAMETER (PARAMETER 4) 



If there are undefined external references in the main pro- 
gram, LOADR printes the message MAIN followed by the 
message UNDEFINED EXTS and then suspends. It is not 
possible to satisfy these undefined external references using 
the loader. The only acceptable request is G0,L0ADR,4 to 
continue loading without satisfying external references, or 
G0,L0ADR,98 to Hst the undefined external references. 

If the last digit is 0, a single main program and subroutines 
will be merged into an absolute program unit. To load 
another main program, the loader must be scheduled again. 



The fmt parameter is specified as a decimal value of five 
digits. The first two (left) digits determine whether or not 
memory space larger than the program size is required. For 
example, programs such as EDITR, ASMB, and LOADR re- 
quire extra memory space to store symbol tables, intermedi- 
ate buffers, and so forth. If space larger than the program 
size is required, the total space required is specified in pages 
of memory; if program size is sufficient, set these digits to 
zero. 

The next two digits determine whether or not the program 
is to be assigned to a specific partition. A program may be 
assigned to any partition of sufficient size regardless of 
partition class (i.e., real-time or background). If a program 
is to be assigned to a partition, specify the partition num- 
ber desired, otherwise, set these digits to zero. If zero, the 
program executes in the smallest available partition possible 
when it is scheduled. 

The LG track area must contain the main program and its 
subroutines followed by a segment and its subroutine. Where 
the same subroutine is required by both the main program 
and segment, but is not in the library, it need only appear in 
the main program. Subroutines required by more than one 
segment, but not by the main, can appear with each segment 
in the LG track area for greater speed in loading. Or, only 
once copy of the subroutine may be placed in the LG track 
area and the area is scanned as a library (loading time is 
somewhat longer). 



LOADING THE BINARY CODE 

For a main/segment load, the main program must be entered 
first to establish the segment area boundaries. The library 
must be scanned (GO,LOADR,I) after each main program . 
and segment (except the last segment). 

The loader scans the relocatable programs and subroutines 
as it reads them, keeping track of any external references. 
If input is initially from the disc as specified by 99 in the 
ON statement, the loader immediately scans the Hbrary for 
entry points. If input is from paper tape and DVROO has 
been configured to logically disable (down) the tape reader 
on end-of-tape (EOT condition), the loader suspends opera- 
tion with the message: 

I/OETL #lu E #eqt S #sub 
/LOADER: LOAD 

LU #lu is unavailable (down, see DN, Section II) until the 
operator declares it up: 

UP, eqt 

If an EOT condition does not cause the tape reader to be set 
down, the RTE system does not send any messages but does 
suspend the loader. 

LOADER RESCHEDULING 



NOTE 

If the loader suspends as a result of 
undefined external references in any 
segment, you may move additional 
subroutines to the end of the LG 
track area and scan the area as a 
library, or have the loader scan the 
input device for required subroutines. 
In Batch mode, the loader aborts. 



After the loader has been suspended, the operator can re- 
schedule it with the GO operator command. 

GO,LOADR (PROGRAM RELOCATION) 



Purpose: 

To reschedule the loader to continue program loading. 

Format: 

GO, LOADR, input option,entry ptsjibrary 
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Where: 
input option 



entry pts 
library 



= 0,2, or 99 indicates a program 
load if library is or not 
entered. 

= — Load from the binary input 
unit (LU5). 

= 1 — Scan disc resident relocatable 
Ubrary and load referenced li- 
brary routines. 

= 2 — Load from LG track area. LG 
track area has been loaded 
from previously. 

= 3 — Load from the relocatable H- 
brary for the last segment in a 
main/segment load. 

= 4 — Continue without loading 
any remaining referenced li- 
brary routines. Ignore unde- 
fined external references. 

= 98 — List undefined externals. 

= 99 — Load from LG track area for 
the first time. 

= lu — Where lu is a logical unit num- 
ber and not one of the above 
numbers. 

= — List entry points. 

= 1 — Omit list of entry points. 

= — Load all data (forced reloca- 
tion). 

= 1 — Satisfy undefined externals 
only (library scan). 



COMMENTS 

If the LG tracks are read with a GO,LOADR,99 (or 2) com- 
mand, the LG track area is not cleared. However, the 
RU,LOADR,99 command will still clear the LG track area 
upon a successful load. 

input option PARAMETER 

• Once you have force loaded from the LG track area, 
subsequent use of the area requires that input 
option - 2. 

• After the loader encounters the last segment during a 
main/segment load from the LG track area, no more 
segments can be read even from the binary input 
device. 

• If undefined externals remain in the main of a seg- 
mented program (which the loader discovers after 



loading the last segment) and the message MAIN- 
UNDEFINED EXTS is printed, the undefined externals 
cannot be satisfied. The only legal response at that 
time is GO,LOADR,98 or 4. 

• It is permissible to use the LG track area more than 
once with GO,LOADR,99 without resetting it with 
the LG command as long as the last load was not a 
forced relocation. 

library PARAMETER 

The library parameter does not apply when input option = 1 , 
3, 4 or 98. If library = 1 then library input from the specified 
source is assumed. If library = then the input is a forced 
relocation. If the library is read through an input device (not 
from the LG track area) and the message LOAD LIB is 
printed, the library must be scanned again to satisfy an un- 
defined external. When the message LOAD is printed, the 
library scan is finished. 

MATCHING EXTERNALS 

External references to resident Ubrary programs use the 
existing base page links to those entry points, but external 
references to disc-resident relocatable library subroutines 
cause these routines to be loaded along with the referencing 
program. If a segment references a library routine also refer- 
enced by the main program, the segment shares the routine 
loaded with the main program. 

After matching all possible entry points to external refer- 
ences, if there are still undefined external references, the 
loader prints this message: 

UNDEFINED EXTS 

The external references are listed, one per line, and the 
loader suspends itself. 

To load additional programs from the input unit, the opera- 
tor types: 

GO,LOADR 

To continue, without fulfilling external references, the 
operator types: 

G0,L0ADR,4 

The loader proceeds to relocate the program or segment and 
subroutines into absolute format, and prints a list (on the 
list device) of all entry points (unless instructed not to print 
the Ust) as each routine is loaded. The entry point listing is: 

"'name address 



4-23 



RTE-III 



Where 

name is the entry point name, and 

address is its absolute location in octal. 

END OF LOADING 

At the end of a normal load, or after loading the last seg- 
ment of a main/segment load, the loader prints the following 
message and terminates itself. 

/LOADR: name READY 
/LOADR: SEND 

Where 

name is the name of the main user program. The loader 

terminates and the program is ready to run. 

After loading a main or segment of a main-segment load 
(end-of-tape mark) the loader prints the foUowing message 
and waits for the GO,LOADR entry for the next segment. 

/LOADR: LOAD 

After entering the last segment and subroutines from the 
input device (not the disc), the operator reschedules the 
loader with the command: 

G0,L0ADR,3 

The loader proceeds to the end of loading, as described 
above. 

The operator can schedule the program for execution by an 
ON, or RU, name operator request (see Section II). The 
disc tracks containing the program are assigned to the 
system and are software-protected. The program, if a 
temporary load, can be eliminated from the system with 
the OF operator command, or if a permanent load can be 
eliminated with the RU,L0ADR„,4 command. 

LOADER OPERATION (ON-LINE EDIT) 

The operator schedules the loader for on-line edit operations 
by setting opcode = 2 in the RU,LOADR command. Refer 
to the RU,LOADR command for more details. 

RU, LOADR, input, list,2,fmt, listing 

The loader requires additional information to carry out the 
modifications so it prints the following message and suspends. 

/LOADR: "GO" WITH EDIT PARAMETERS 



The operator must disable (override) the hardware disc pro- 
tect switch and reschedule the loader. 

LOADER RESCHEDULING (ON-LINE EDIT) 

The operator reschedules the loader with the GO operator 
command. This GO,LOADR command for on-line edit 
operations contains an additional command. 

GO,LOADR (On-Line Edit) 



Purpose: 




To reschedule the loader to input additional param- 


eters required for the edit operation. 


Format: 




GO,LOADR,operation,prog type [,priority] 


Wliere: 




operation 


= 1 for an addition operation. 




= 2 for a replacement operation (pro- 




gram must be dormant). 


prog type 


= 2 for a real-time disc-resident program. 




= 3 for a background disc-resident 




program. 


priority 


= priority (optional) from to 32767 




(a means use the priority value in the 




NAM record of the program or, if that 




priority is 0, uses 32767). 



COMMENTS 

Any errors encountered while attempting to reschedule the 
loader cause the error message LIO to be printed (see 
LOADR ERROR MESSAGES). The disc hardware protect 
must be disabled before the program is loaded, then re- 
enabled after loading. 

Wlien the GO request is entered, the loader proceeds to load 
the program, keeping track of any external references. If in- 
put is from the disc as specified by 99 in the ON statement, 
the loader immediately scans the Ubrary for entry points. If 
input is from paper tape, the loader suspends with the 
message. 



I/O ET L #lu E #eqt S 
/LOADER: LOAD 



#sub 



LU #lu is unavailable (down; see DN, Section II) until the 
operator declares it up. 
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lJ?,eqt 

The operator reschedules the loader with the GO request 
exactly as described previously under GO,LOADR (Back- 
ground). 

RTE DEBUG LIBRARY SUBROUTINE 

DEBUG, a utility subroutine of the RTE Relocatable Li- 
brary is appended to the user's program by the loader when 
the opcode parameter in the RU,LOADR command is set to 
1 , and allows programs to be checked for logical errors dur- 
ing execution. Programs that expect starting parameters or 
that call RMPAR (see Section III, Program Suspend Exec 
Call) cannot use DEBUG because DEBUG uses these param- 
eters. 

The DEBUG routine was developed for 2100 series com- 
puters. It should not be used with instructions labeled as 
"21 MX Only" in the RTE Assembler Reference Manual 
(92060-90005). 

After the user's program is loaded with DEBUG appended 
to it, the user turns his program on with the input parameter 
set to 1 (keyboard input). 

RU,«ame,l 

Where 

name is the program name. 

The primary entry point of the program (the location where 
execution begins) is set to DEBUG so that when the pro- 
gram is turned on with an RU operator request, DEBUG 
takes control and prints a message: 

BEGIN 'DEBUG' OPERATION 

You can then enter any legal debug operation. Illegal re- 
quests are ignored and a message is printed. 

ENTRY ERROR 



M,« Sets absolute base of relocatable 

program unit at octal address n 

R[,«] Execute user program starting at 

octal address n or execute starting 
at next location in user program 
(used after a breakpoint or to init- 
iate the program at the transfer 
point in the user program) 

S,n,d Set octal value d in octal address n 

S,n,d[ ,(^2' • • • >^^ Set octal values d^ through d in 

successive memory locations begin- 
ning at octal address n 

W,A,<i Set A-register to octal value d 

W,B,d Set B-register to octal value d 

W,E,J Set E-register to octal value d 

(0 = off; non-zero = on) 

W,0,c? Set Overflow to octal value d 

(0 = off; non-zero = on) 

X,n Clear breakpoint at octal address n 

A Abort DEBUG operation. 

LOADR ERROR MESSAGES 

Messages are printed in this format: 

/LOADR: message 

WARNING (W) MESSAGE 

W17 — Number of pages required by the program exceeds 
the partition size. The loader cannot find a parti- 
tion large enough for the program. It can be relo- 
cated successfully but cannot be executed. You 
can generate a new system containing a partition 
large enough for the program or you can revise the 
program. 



The following commands describe DEBUG operations. 



B,n 



D,A,n|[,«2] 
D,B,«i [,^2] 



Instruction breakpoint at octal 
address n (Note: if n = JSB EXEC, 
a memory protect violation occurs) 

ASCII dump of octal main memory 
address rti or from « r through «2 

Binary dump of octal main memory 
address n 1 or from n 1 through n^ 



L ERROR MESSAGES 

LOl — Checksum error 
L02 — Illegal record 

These errors are recoverable (except in Batch mode). The 
record in error can be reread by repositioning the tape to the 
beginning of the record and typing: 

GO,LOADR 
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L03 — Memory overflow. 

L04 -- Base page linkage area overflow. 

L05 — Symbol table area overflow. 

L06 — Common block error. 

a. Exceeding allocation in a replacement or 
addition. 

b. In a normal background load, first program 
did not declare largest common block. 

L07 - Duplicate entry points 

LOS - No transfer address (main program) in the pro- 
gram unit. Another program may be entered with 
a GO operator request. (This also occurs when the 
LG track area is specified, but no program exists in 
that area.) 

L09 — Record out of sequence. 

LIO ~ Operator request parameter error. GO requests 
may be retyped; ON requests may not. 

Lll — Operator attempted to replace or purge a memory 
resident program. 

LI 2 — LG track area used without presetting (input 

option = 2 IN 'GO')- input option was not speci- 
fied as 99 previously. 

LI 3 — LG track area has been illegally reset (i.e., over- 
written). Program addition on area not allowed if 
it has already been specified for program input, or 
area was once used for force loading with input 
option = 99 and it is again being used with input 
option = 99 (must = 2). 

LI 4 — Assembler or compiler produced illegal relocatable. 
A DBL recor-d refers to an external which has not 
been defined (the original can not be found in the 
symbol table). 

Li 5 - Forward reference to a type 3 or type 4 ENT or to 
an EXT with offset which has not yet been 
defined, or an indirect forward reference. 

Li 6 — Illegal partition number. Value must be in the 
range from 1 through 64. 



LI 7 - Number of pages required by the program exceeds 
assigned partition size, A specific partition has 
been assigned for this program. This program re- 
quires more pages than are available in the partition. 



LIS - Total number of pages required exceeds 32. The 
sum of required pages must be in the range from 
1 through 32. 



ADDITIONAL MESSAGES 

NO BLANK ID SEGMENTS 

This message is printed when no available (i.e., blank) ID 
segment is found. The loader calls for program suspension. 
The operator may then delete a program from the system 
{OF,name,S operator request) or may terminate the loader. 

DUPLICATE PROG NAME -- name 

This message is printed when a program name is already 
defined in the system for a normal load or a program addi- 
fion. The loader changes the name of the current program 
by replacing the first two characters with periods (e.g., 
JIMBl becomes . .MBl). The second duphcate program 
name aborts the loader. 

WAITING FOR DISC SPACE 

This message is printed when a track allocation cannot be 
made. The loader repeats the disc request and is suspended 
until space becomes available. 

UNDEFINED EXTS 

This message is printed followed by a hst of all remaining 
undefined external symbols after a scan of the hbrary. Addi- 
tional programs may be loaded by the GO operator request. 

LOAD 

This message is printed and the loader is suspended when- 
ever an end-of-tape condition is detected from the input 
unit. 

SET PRGM INACTIVE 

This message is printed if the loader attempts to replace a 
program that is not dormant, is in the time Ust, or has a non- 
zero point of suspension. The program to be replaced must 
be set inactive using the OF operator request. 

LOAD LIB 

This message is printed when an end-of-tape condition is 
detected from the input device being used for library input 
and the loader needs to scan the library again. 
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PARTS 
RTE Relocatable Library 



INTRODUCTION 

DOS/RTE Relocatable Library Reference Manual (24998- 
90001) describes the subroutines contained in the following 
relocatable libraries: 



FORMAT OF RE-ENTRANT ROUTINE 



Library Mnemonic 

RLIB.N 

FF4.N 

FF.N 



Library Name 

DOS/RTE Relocatable Library 
FORTRAN IV Formatter 
FORTRAN Formatter 



In addition to the above libraries there is a system library 
which contains routines unique to the RTE-III System. 
These routines are documented in this section. 



RE-ENTRANT SUBROUTINE STRUCTURE 

Many executing programs can reference one resident library 
subroutine on a priority basis. If the subroutine is struc- 
tured as re-entrant, it must not modify any of its own 
instructions; and it must save temporary results, flags, etc., 
if it is called again (by a higher priority program) before 
completing its current task. 

Each time the re-entrant routine begins executing, the ad- 
dress and length of its temporary data block are transferred 
to RTE-III through entry point $LIBR to save the data. At 
the end of execution, the re-entrant routine calls RTE-III 
through entry point $LIBX to restore the temporary data, 
if any. 

Re-entrant structure is used for programs with an execution 
time exceeding one milHsecond. For shorter execution 
times, the overhead time the system uses in saving and re- 
storing temporary data makes re-entrant structure unrea- 
sonable. Faster subroutines can be structured as privileged. 

NOTE 

A hbrary (type 6) program can only 
call another Ubrary program or 
system (type 0) program. 



NAM 
EXT 



xxxxx,6 
$LIBR, $LIBX 



ENTRY NOP 
JSB 



Entry point of routine. 

SLIBR Call RTE-III to save temporary 
data. 
DEF TDB Address of temporary data. 



EXIT 



JSB 

DEF 

DEC 



m 



TDB 



NOP 
DEC 
NOP 



Program instructions 

$LIBX Call RTE-III to restore data. 

TDB 

m is for routines with two return 
points in the calling program; 
specifies the error-point return 
and 1 the normal return. For rou- 
tines with only one return point, 
m = 0. 

System control word. 
Total length of current block. 
Return address to calling program. 



«+3 



Tl 



In 



Temporary data (« words). 



PRIVILEGED SUBROUTINE STRUCTURE 

Privileged subroutines execute with the interrupt system 
turned off. This feature allows many programs to use a 
single privileged subroutine without incurring re-entrant 
overhead. As a result, privileged subroutines need not save 
temporary data blocks but must be very quick in execution 
to minimize the time that the interrupt system is disabled. 
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RTE SYSTEM 
LIBRARY 



) 



INCLUDE 
RLIB.N 



INCLUDE 
FF4.N 



YES 




INCLUDE THEM 

IN ORDER 

SUGGESTED 



NO 




YES 



INCLUDE 
FF.N 




NO 



■c 



END 



3 



Figure 4-1. RTE Library Selection 



Re-entrant and privileged routines may be placed in the 
resident library during generation by either of the following 
methods. 

• If the routine is declared as an external (called) by a 
resident (type 1) program, or is called by another 
resident library routine, the routine will automatically 
be placed in the resident library by the generator. 

• The routine can be changed during the parameter in- 
put phase of generation to a type 14 routine (it also 
could have been assembled as a type 14). 

Note that type 6 routines not put in the resident library 
are changed to utility routines (i.e., type 7). 



UTILITY SUBROUTINE STRUCTURE 

Utility subroutines are subroutines which cannot be shared 
by several programs because of internal design or I/O opera- 
tions. A copy of the utility routine is appended to every 
program that calls for it. The library subroutine FRMTR 
(FF .n) or EMTIO (F4D.n) which carries out FORTRAN 
I/O operations, and the PAUSE subroutine are examples of 
utility routines. 

When the RTE-III System is generated, all library sub- 
routines not included in the resident Hbrary are loaded 
immediately following each user program requiring them 
during program relocation. 



FORMAT OF PRIVILEGED ROUTINE 

MAM xxxx , 6 

EXT $LIBR,$LIBX 

ENTRY NOP Entry points to the routine. 

JSB $LIBR Call RTE-III to disable the interrupt 
"Vstem and memory protect fence. 
Denotes privileged format. 



NOP 



EXIT JSB $LIBX Call RTE-III to return to calling 

program and enable interrupts and 
memory protect fence. 
DEF ENTRY Location of return address. 



RE-ENTRANT I/O 

A re-entrant subroutine may do I/O using the standard 
EXEC requests. If the buffer is in the temporary data block 
(TDB) of either itself or another re-entrant routine that 
called it, the calling program is swappable. If the buffer is in 
the user area the program is not swappable. (i.e., if the 
buffer is not in the TDB or user common area the program 
is not swappable). 
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A subroutine called REIO is furnished to allow the user to 
do re-entrant I/O. REIO is a utility type Hbrary routine that 
has within its structure a re-entrant routine. Therefore, the 
routine may not be put in the resident library, it must be 
appended to each program that calls it. 

The calling sequence for REIO is: 

CALL REIO (ICODE , ICNWD , IBUFR, IBUFL) 

where the parameters are described in the READ/WRITE 
EXEC call in Section III of this manual. Note that REIO 
can only be used with READ/WRITE calls and that the 
optional parameters available in those calls are not allowed 
in the REIO call. REIO will always do the requested I/O; 
however, it will do re-entrant I/O only if the buffer is less 
than 130 words (to save system memory), and the buffer 
address is at least three words above the current fence 
address. If the sign bit is set on ICODE the same error 
options available with the EXEC Call are effected (i.e., 
error return followed by normal return). REIO returns the 
same values in the A- and B-Registers as the standard EXEC 
Call. 

OTHER SUBROUTINES 

Several other subroutines are provided for programming 
convenience. The basic calling sequences are provided here 
for reference. 

BINRY 

FORTRAN programs can call BINRY, the disc read/write 
library subroutine, to transfer information to or from the 
disc. The call must specify a buffer array, the array length 
in words, the disc logical unit number, track number, sector 
number, and offset in words within the sector. (If the offset 
equals 0, the transfer begins on the sector boundary; if the 
offset equals n, then the transfer skips n words into the 
sector before starting.) BINRY has two entry points: 
BREAD for read operations and BWRIT for write 
operations. 

For example, 

CALL BWRIT (ARRAY ,N , IDISC , ITRK, ISECT , lOFST) 
CALL BREAD (ARRAY ,N , IDISC , ITRK, ISECT, lOFST) 



Where: 

ARRAY 

N 

IDISC 

ITRK 

ISECT 

lOFST 



Address of the first element 

Number of words 

Disc logical unit number 

Starting track number 

Starting sector number 

Number of words offset within a sector 



There are three basic ways that data can be written on the 
disc in relation to sector boundaries. Care must be used in 
planning the WRITE statement in two of the cases to avoid 
losing existing data. 

One form of writing data on the disc is offset=« (i.e., trans- 
fer begins within a sector), and less than the sector is 
written, or the data transfer ends on a sector boundary. The 
entire first sector is initially read into an internal buffer, the 
data is modified according the BWRIT statement, and then 
the entire sector is rewritten on the disc with no data loss. 
No special precautions are required in this instance. 

A second form of writing data on the disc is offset=0 (i.e., 
transfer begins on a sector boundary), and less than the 
sector is written. The remaining data in the sector will be 
lost if the following precaution is not taken. The entire 
existing sector on the disc can first be read into a user's 
buffer, modified to reflect the desired changes, and then 
rewritten on the disc as a full sector. 

A third form of writing data on the disc is offset=0 or n, 
and a sector boundary is crossed in the data transfer. The 
remaining data in the final sector will be lost if the follow- 
ing precaution is not taken. The entire final sector (of the 
data transfer) on the disc should be read into a user's buf- 
fer, modified to reflect the desired changes, and then re- 
written on the disc as a full sector. 




The following subroutine is used to parse an ASCII string. 
The calling subroutine must be privileged when using the 
following Assembly Language calling sequence: 



buffer address 
character count 



LDA BUFAD 

LDB CCOUN 

EXT $PARS 

JSB $PARS 

DEF RBUF 
-return- 
Where RBUF is 33 words long. The result of the parse of 
the ASCII string at BUFAD is stored in RBUF using 4 
words per parameter and are set as follows: 



Word 



Entry 



1 FLAG WORD 



VALUE(l) 



= NULL 

1 = NUMERIC 

2 = ASCII 

If NULL; Value if Numeric; 
first 2 characters if ASCII. 
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3 VALUE(2) If NULL or numeric else 

the 3rd and 4th characters. 

4 VALUE(3) If NULL or numeric else 

the 5th and 6th characters. 

ASCII parameters are separated from numeric parameters 
by examination of each character. One or more non-digit 
characters (except a trailing "B" or leading "-") makes a 
parameter ASCII. 

The 33rd word of RBUF will be set to the number of 
parameters in the string. 

The Parse routine ignores all blanks and uses commas to 
dehmit parameters. ASCII parameters are padded to 6 char- 
acters with blanks or, if more than 6 characters, the left 
most 6 are kept. Numbers may be negative (leading "-") 
and/or octal (trailing "B"). 

A FORTRAN callable interface to SPARS is provided with 
the calling sequence as follows: 



V 



CALL PARSE ' (IBUF1,ICCNT,IBUF2) 



Where 

IBUFl is an array containing the string to be parsed 
ICCNT is the character count 

IBUF2 is a 33 word array that will contain the result^ 
of the parse. 

BINARY TO ASCII CONVERSION SUBROUTINES 

The $CVT3 subroutine is used to convert an integer binary 
number of ASCII. Note that the calling program must be 
privileged when using the following Assembly Language 
calling sequence: 

LDA numb 

CLE or CCE (see text) 
EXT $CVT3 
JSB $CVT3 
-return- 
E=l, 

A=address of result 
B=value at invocation 

$CVT3 converts the binary number in the A-Register to 
ASCII, suppressing leading zeros, in either OCTAL (E = 0) 
or decimal (E = 1). On return, the A-Register contains the 
address of a three word array containing the resultant ASCII 
string.' 



SCVTl has the same calling sequence as SCVT3 except that 
on return, the A-Register contains the least two characters 
of the converted number. 

A FORTRAN callable interface to $CVT3 is provided with 
the calling sequence as follows: 

(decimal) CALL CNUMD {binary nwnh^addr) 
(octal) CALL CNUMO (binary numbjaddr) 

where binary numb is the binary number to be converted 
and addr is the address where a three word array (6 ASCII 
characters) begins. Leading zeros are suppressed. (For 
CNUMD, the number must not be negative.) 



The following subroutine converts a variable to ASCII base 
10 and returns the least two digits in "I". The FORTRAN 
calling sequence is: 

I=KCVT(J) 

MESSAGE PROCESSOR INTERFACE 

The message processor processes all system commands. See 
Section II. A FORTRAN call to the system message pro- 
cessor is provided with the calling sequence as foUov/s: 

I = MESSS (IBUFA,ICOUN,LC/) 

Where IBUFA contains the ASCII command, ICOUN is an 
integer containing tlie character count, and LU is optional. 

The value on return will be zero if there is no response or 
the negative of the character count, if there is a message. 
The message, if any, will be in IBUFA. 

If the request is RU or ON (starting in 1st column) and the 
first parameter is zero or absent, then the first parameter 
will be replaced by LU. LU is optional. If it is not suppHed, 
no action takes place. 

If the request is LU, EQ, or TO (starting in first column), 
any resulting message will be written to the device specified 
by LU. If LU is not given, the message will be sent to the 
system console. No message is returned to the caller for 
these commands. 



INTERRUPTING LU QUERY 

A calling sequence is provided to find the logical unit num- 
ber of an interrupting device from the address of word four 



4-30 



RTE Relocatable Library 



of its equipment table entry. The address of word four is 
placed in the B-Register by the driver and used in the fol- 
lowing sequence: 

LDB EQT4 (done by DVROO and DVR65) 

Not necessary if address of EQT4 has already been placed 
into 'B' by driver, or by another program/subroutine. 

EXT EOLU 

JSB EOLU 

DEF *+2 or *+! 

DEF LUSDI 

EQLU will return with: 

A-Register = if an LU referring to the EQT was not 
found. 

= LU if the LU was found. 

B-Register = ASCII "00" or the LU number in ASCII 
e.g., "16." 

LUSDI = (optional parameter) value is returned to this 

parameter, as well as in the A-Register. 

Other variations of the call are (passed from DVROO or 
DVR65): 



DEF *+2 
DEF SIX 



IPRAM BSS 5 PARAMETER BUFFER 
SIX DEC 6 PROGRAM TERMINATION CODE 

The FORTRAN calling sequence is: 

DIMENSION IPRAM (5) 



CALL PRTN( IPRAM) 
CALL EXEC (6) 

The second routine is called PRTM, passes four parameters, 
and does not clear the wait flag. When the parameters are 
recovered with RMPAR, the first parameter is meaningless. 
The Assembly Language calling sequence is: 

EXT PRTM 
JSB PRTM 
DEF *+2 
DEF IPRAM 



EXT EQLU 
JSB EQLU 
DEF *+l 
STA LU 
STB ASCLU 
-or- 
LU=EQLU (LU) 



IPRAM BSS 4 

INDIRECT ADDRESS SUBROUTINE 

This routine is used to find an indirect address. The Assem- 
bly Language calling sequence is: 



PARAMETER RETURN SUBROUTINES 

There are two routines used to pass parameters to the pro- 
gram that scheduled the caller with wait. The scheduling 
program may recover these parameters with RMPAR. 

The first routine is called PRTN, passes five parameters, and 
clears the wait flag. This means that the caller should termi- 
nate immediately after the call. The Assembly Language 
calling sequence is: 

EXT EXEC, PRTN 
JSB PRTN 
DEF *+2 
DEF IPRAM 
JSB EXEC 



EXT .DRCT 
JSB .DRCT 
DEF ADDR 
-return- 

The routine returns with the A-Register set to the direct 
address of ADDR, the B-Register unaltered, and the E- 
Register lost. This routine is usually used when ADDR is 
external. 



BREAK FLAG TEST SUBROUTINE 

This routine tests the break flag and if set clears it. The 
FORTRAN calling sequence is: 

IF (IFBRK(IDMY)) 10,20 
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Where: 

10 branch will be taken if the break flag is set. The flag will 
be cleared. 

20 branch will be taken if the break flag is not set. 

IDMY must be used in order to inform the FORTRAN 
compiler that an external Function is being called. (It is not 
needed for ALGOL.) 

In the Assembly Language calling sequence: 

JSB IFBRK 
DEF *+l 
-return- 

The A- Register will = - 1 if the break flag is set and = 
if not. The break flag will always be cleared if set. 

FIRST WORD AVAILABLE MEMORY SUBROUTINE 

This routine finds the address of the first word of available 
memory for a given ID segment. The Assembly Language 
calling sequence is: 

EXT COR. A 

LDA IDSEG 

JSB COR. A 

-return- 



The ID segment address is loaded into the A-Register and 
the routine is called. On return the A-Register contains the 
first word of available memory (MEM2 from ID). Note that 
on entry into a segment, the A-Register contains the seg- 
ments ID segment address. 

CURRENT TIME SUBROUTINE 

Tliis routine reformats and returns the time in miUiseconds, 
seconds, minutes, hours, and the day. The FORTRAN call- 
ing sequence is: 

CALL TMVAL (ITM,ITMAR) 
Wliere : 

ITM is the two word negative time in tens of milli- 

seconds. This double word integer can be ob- 
tained from the system entry point $TIME or 
the time values in the ID segment. 

ITMAR is a five word array to receive the time. The 
array is set up as: 
tens of milliseconds 



seconds 
minutes 
hours 

current system day of year (not related to call 
values) 

BUFFER CONVERSION SUBROUTINE 

This routine converts a buffer of data back into its original 
ASCII form. The user passes the routine a buffer (IRBUF), 
plus the number of parameters in the buffer, that looks Uke 
the buffer returned by the PARSE routine. INPF^S then 
reformats the buffer into an ASCII string that is syntacti- 
cally equivalent (under the rules of PARSE) to a buffer that 
may have been passed to PARSE to form IRBUF. The 
length of the ASCII string in characters will be 8 times the 
number of parameters. The FORTRAN calling sequence is: 

CALL INPRS (IPRBF^IPRPF(33)) 

Where: 

IPRBF is the buffer IRBUF 

IPRBF (33) is the number of parameters parsed 

RECOVER PARAMETER STRING 

The routine GETST recovers the parameter string from a 
program's command string storage area. The parameter 
string is defined as all the characters following the second 
comma in the command string (third comma if the first 
parameter is NO). The Assembly Language calling sequence 
is: 

EXT GETST 



Call subrout;Lne 
Return address 
Buffer Location 
Buffer length 
Transmission Log 
Continue execution 

Buffer of n words 
Same n; words ( + ) 
or characters (-) 
Error information 





JSB GETST 




DEF RTN 




DEF IBUFR 




DEF IBUFL 




DEF ILOG 


RTN 


return point 


IBUFR 


BSS n 


IBUFL 


DEC n(or -2n 



ILOG 



NOP 



Upon return, ILOG contains a positive integer giving the 
number of words (or characters) transmitted. The A- and 
B-Registers may be modified by GETST. Note that if 
RMPAR is used, it must be called before GETST. 

Wlien an odd number of characters is specified, an extra 
space is transmitted in the right half of the last word. 
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PART 6 
Segmented Programs 



Background disc-resident programs may be structured into 
a main program and several overlapping segments, as shown 
in Figure 4-2, The main program begins from the start of the 
background partition (after base page), and must be loaded 
during RTGEN or with the loader prior to its segments. The 
area for overlay segments starts immediately following the 
last location of the main program. The segments reside 
permanently on the disc, and are read in by an EXEC call 
when needed. Only one segment may reside in core at a 
time . 



Bockqround . 

Partition "* 



SEGMENT 

OVERLAY 

AREA 



MAIN PROGRAM 



PARTITION BASE PAGE 



PHYSICAL MEMORY 



MAIN PROGRAM 



SEGMENTS 
SEGMENT 2 

SEGMENT 1 




MAIN PROGRAM 



DISC MEMORY 



NOTE: TRACK, SEGMENT, 
AND GAP SIZES ARE 
EXAGGERATED. 
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RTE ALGOL SEGMENTATION 

ALGOL programs can be segmented if certain conventions 
are followed. The main program must be primary type 3, 
and the segment must be type 5 in the HPAL statement. 
The segment must be initiated using the Program Segment 
Load EXEC call from the main or another segment 

To establish the proper hnkage between a main program 
and its segments, each segment must declare the main 
program a CODE procedure. For example, if MAIN is the 
main program, the following must be declared in each 
segment: 

PROCEDURE MAIN; CODE; 

Chaining of segments is unidirectional. Once a segment is 
loaded, execution transfers to it. The segment, in turn, may 
call another segment using an EXEC call, but a segment 
written in ALGOL cannot easily return to the main program. 

RTE FORTRAN SEGMENTATION 

FORTRAN programs can be segmented if certain conven- 
tions are followed. The main program mus-t be type primary 
3, and the segment must be type 5 in the PROGRAM 
statement. The segment must be initiated using the Program 
Segment Load EXEC caU from the main or another 
segment. 

Each segment must make a dummy call to the main 
program. In this way, the proper linkage is established 
between mains and segments: 



Figure 4-2. Segmented Programs 



CALL MAIN 
END 

Chaining of segments is unidirectional. Once a segment is 
loaded, execution transfers to it. The segment, in turn, may 
call another segment, but a segment written in FORTRAN 
cannot easily return to the main program. Segments can call 
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any subroutine attached to the main program. Communica- 
tion between the main program and segments may be 
through COMMON. 

RTE ASSEMBLER SEGMENTATION 

The main program must be primary type 3, and the segments 
must be type 5. One external reference from each segment 
to its main program is required for RTGEN to link the seg- 
ments and main programs. Also, each segmented program 
should use unique external reference symbols. Otherwise, 
RTGEN or the loader may hnk segments and main programs 
incorrectly. 

Figure 4-3 shows how an executing main program may call 
in any of its segments from the disc, via a "J SB EXEC." 
The main program is not suspended, but control is passed 
to the transfer point of the segment. 




TPRTE-IO 



Figure 4-4. Segment Calling Segment 



An executing segment may itself call in another of the main 
program's segments using the same "J SB EXEC" request. 
(See Figure 4-4). However, a segment of the FORTRAN or 
ALGOL compiler may not call in a segment of the 
Assembler. 

When a main program and segment are currently residing in 
core, they operate as one single program. Jumps from a 
segment to a main program (or vice versa) can be 
programmed by declaring an external symbol and 
referencing it via a J MP instruction. (See Figure 4-5.) A 
matching entry symbol must be defined at the destination 
in the other program. RTGEN and the loader associate the 
main programs and segments, replacing the symbolic 
linkage with actual absolute addresses (i.e., a jump into a 
segment is executed as a jump to a specific address). The 
programmer should be sure that the correct segment is in 
core before any JMP instructions are executed. 



SEGMENT 2 

SEGMENT 1 



NAMSEG1 
EXT EXEC 




MAIN PROGRAM 

DISC MEMORY 



RESIDENT LIBRARY 



REAL TIME 
EXECUTIVE 



(SEGMENT OVERLAY 
AREA) 

♦ 



BACK6R0UND 

PROORAM 

AREA 



LOGICAL 
MEMORY 



EXT Ml 
ENTS1 
SI JMP Ml' 



(Segments) 




MAIN PROGRAM 



MEMORY 
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Figure 4-5. Main-to-Segment Jumps 
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Figure 4-3. Main Calling Segment 
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PART 7 
Multiple Terminal Operation 



Through Class Input/Output, which consists of initiating an 
I/O request without wait, the RTE-III System will support 
multiple operator consoles. This means that more than one 
operator can have access to the system and a single program 
simultaneously. To properly understand the capabilities of 
multiple terminal operation, one must first understand the 
different ways in which a single minicomputer can interact 
with more than one terminal, 

MULTIPROGRAMMING 

Under the scheme of multiprogramming, each terminal has 
its own unique and separate copy of a particular program. 
This is accomplished by renaming the program with the File 
Manager RN command as many times as required. When the 
operator at any terminal desires the system's attention he 
simply strikes a key which causes an interrupt. The system 
returns the prompt character back to the terminal signaling 
the operator that he has the system's attention. The 
operator can then activate his copy of the program until a 
resource limitation or higher priority interrupt occurs. For 
example, two users would be using the editor and one user 
would be using BASIC; the master copy of the editor would 
be on the disc, but two copies of the editor would be 
swapped in the background area. Most often, the operator 
will use the RUn command to cause a program to be 
initiated; for example, RU,EDITR. The multiterminal 
monitor will then cause the editor program to be executed 
using the given terminal as an input/output device. The 
given terminal is used because its logical unit number is 
placed in the first parameter following the program's name 
since in the above example that parameter was left out. If 
the user desires to use another I/O device for input/output 
then its logical unit number should be supplied immediately 
following the program name. For example, RU,EDITR,14 
would schedule the editor program and specify logical unit 
14 as the I/O device. 

Programs and resources are given priorities according to 
their interaction with the system as follows: 

Real-Time Programming — Highest 



Interactive Programming 
Editor 

BASIC - Middle 

FMGR 

Bit Manipulation 
ASMB 

LOADR - Lowest 

FTN 

MULTITASKING 

In multitasking multiple programs exist as in multi- 
programming, but the programs must communicate data 
and control flags to each other in order to synchronize their 
efforts. For example, one program may handle data 
gathering while another program would handle queries for 
statistical analysis of the data; both programs would be 
coordinated by a third program to provide a consistent and 
simple interface to the terminal user. These multitasking 
functions are performed in RTE-III with the following calls. 

Class I/O calls 
Schedule with wait 
Schedule without wait 
Schedule and pass parameters 
Allocate resource numbers 
Logical unit lock 

OPERATION 

Multiple terminal operation requires that two routines, 
PRMPT and R$PN$ (HP Part No. 92001-16003) be 
configured into the system during generation and that these 
routines be assigned a reasonably high priority. The 
Interrupt Table is set up so that an interrupt generated by a 
terminal schedules the PRMPT routine which in turn 
schedules R$PN$. Then, as soon as any key is struck on the 
terminal, PRMPT issues the prompt character back to the 
terminal signaling the operator that he has the system's 
attention. Input from the operator is processed by R$PN$. 

Any legal operator request is valid for input (e.g., ON, or 
ST, etc.): however, if an ON or RU command is given and 
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the first parameter is not specified, R$PN$ will default that 
parameter to the" input terminal's logical unit number. The 
following examples show how the multiple terminal monitor 
(MTM) might be used. 

Example: 

A key on one of the terminals is struck. The terminal 
responds as follows: 

14> 

You desire to run the Interactive Editor EDITR. 



example using the Interactive Editor, it can be renamed 
several times on-line with the File Manager RN command. 
The following series of File Manager commands 
demonstrates how this is accomplished. 

PK 

RN, EDITR, EDITl 

RP,EDIT1 

RN, EDITl, EDIT2 

RP,EDIT2 

RN,EDIT2,EDIT3 

RP,EDIT3 ' 

RN,EDIT3, EDITR 



14 > RU, EDITR 

Since there is no parameter (specifically a logical unit 
number) following EDITR, MTM takes the logical unit 
number of the interrupting device (14 in this example) and 
uses it for I/O. If a logical unit number had been provided 
then I/O would have taken place through that device. In the 
above case EDITR would respond with 

SOURCE FILE ? 



and you would be on your way using the Interactive Editor. 

Programs to be scheduled for operation from several 
terminals must be swappable. That is, the program must 
perform all I/O through the re-entrant subroutine REIO 
instead of EXEC calls or otherwise maintain their 
swappability. An additional requirement is that each 
terminal must access the program by using a different 
Program ID Segment (different program name). 

NOTE 

Since the Logical Source (LS) and 
LG areas may only be used by 
one program at a time, it is rec- 
ommended that programs such as 
ASMB, FTN4, etc. should not 
be assigned duplicate ID segments 
for multiple terminal operations. 



When a program is to be used by several terminals it must 
be accessed by a different name in each case. In the above 



Note that the above commands can be put in a file that will 
be run each time the system is booted up. This relieves the 
user the responsibility of renaming all programs for MTM 
use if the system should go down and have to be rebooted. 

The Pack (PK) command in the above example is issued 
first to recover disc space. However, if a program file is 
assigned to an ID segment, the disc may not be packed (see 
the Batch and Spool Manual). 

The last rename command restores the file's original name 
for future use. It is recommended that a different number 
be assigned to each copy of the program so that the 
operator of each terminal may run the program without 
confusion as to which one is already being run by another 
terminal. Output which has been buffered up for a terminal 
may be stopped and completely ehminated by entering the 
Flush (FL) command. 



SYSTEM CONFIGURATION 

The routines PRMPT and R$PN$ are loaded into the 
system during the Program Input Phase, and are assigned a 
reasonably high priority during the Parameter Input Phase. 
When the Interrupt Table is formed, and entry for PRMPT 
is made as follows: 

select code, PROG, PRMPT 

After the RTE-UI System is initialized and running, each 
terminal must be initialized with a control request through 
either a File Manager command or an EXEC request. 

:CN, /u,20B -or- CALL EXEC (3,20B) 



4-36 



SECTION V 
REAL-TIME INPUT/OUTPUT 



Table 5-1 . Equipment Table Entries 



In the Real-Time Executive System, centralized control and 
logical referencing of I/O operations effect simple, device- 
independent programming. Each I/O device is interfaced to 
the computer through an I/O controller associated with one 
or more I/O channels which are linked by hardware to cor- 
responding memory locations for interrupt processing. By 
means of several user-defined I/O tables, self-contained 
multi-device drivers, and program EXEC calls, RTE-III 
relieves the programmer of most I/O problems. 

For further details on the hardware input/output organiza- 
tion, consult the appropriate computer manuals. 



SOFTWARE I/O STRUCTURE 

An Equipment Table records each controller's I/O 
channels, driver, DMA, buffering and time-out specifica- 
tions. A Device Reference Table assigns one or more 
logical unit numbers to each device and points each device 
to the appropriate Equipment Table entry, allowing the 
programmer to reference changeable logical units instead 
of fixed physical units. 

An Interrupt Table directs the system's action when an 
interrupt occurs on any channel; RTE-III can call a driver 
(which is responsible for initiating and continuing opera- 
tions on all devices' controllers of an equivalent type), 
schedule a specified program, or handle the interrupt itself. 

The programmer requests I/O by means of an EXEC call in 
which he specifies the logical unit, control information, 
buffer location, buffer length, and type of operation. Other 
subsystems may require additional parameters. 

THE EQUIPMENT TABLE 

The Equipment Table (EQT) has an entry for each I/O 
controller recognized by RTE-III (these entries are 
established by the user when the system is generated). 
These 15-word EQT entries reside in the system, and have 
format as shown in Table 5-1. 



Word 


Contents 




15 


14 13 12 


11 109 


876 


543 


2 1 


1 


I/O Request List Pointer 


2 


Driver "Initiation" Section Address 


3 


Driver "Completion" Section Address 


4 


D 


B 


P 


S 


T 


Unit # 


Channel # 


5 


AV 


EQ TYPE CODE 


STATUS 


6 


CONWD (Current I/O Request Word) 


7 


Request Buffer Address 


8 


Request Buffer Length 


9 


Temporary Storage for Optional Parameter* 


10 


Temporary Storage for Optional Parameter* 


11 


Temporary Storage for Driver 


12 


Temporary Storage for Driver (EQT extension 
size) 


13 


Temporary Storage for Driver (EQT extension 
starting address 


14 


Device Time-Out Reset Value 


15 


Device Time-Out Clock 



*Modified by RTE at each I/O initialization. 
Where: 

= 1 if DMA required. 

= 1 if automatic output buffering used. 

= 1 if driver is to process power faU. 

= 1 if driver is to process time-out. 



= 1 if device timed out (system sets to zero 
before each I/O request). 
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Unit 
Channel 

AV 


1 

2 
3 



= Last sub-channel addressed. 

= I/O select code for the I/O controller (lower 
number if a multi-board interface). 

= I/O controller availability indicator: 

= available for use. 

= disabled (down). 

= busy (currently in operation). 

= waiting for an available DCPC channel. 



STATUS = the actual physical status or simulated status 
at the end of each operation. For paper tape 
devices, two status conditions are simulated: 
Bit 5 = 1 means end-of-tape on input, or 
tape supply low on output. 



EQ 

TYPE 

CODE 



00 to 07 

00 

01 

02 

05 sub = 

05 sub 1 

05 sub 2 

10 to 17 = 

10 

11 

12 

15 

20 to 37 

31 

32 

40 to 77 = 

CONWD = 



type of devices on this controller. When this 
octal number is linked with "DV" it 
identifies the device's software driver 
routine as follows: 

paper tape devices (or system control 

devices). 

teleprinter (or system keyboard control 

device). 

photoreader. 

paper tape punch. 

console (or system Keyboard control device). 

mini cartridge. 

devices 

unit record device. 

plotter. 

card reader. 

line printer. 

mark sense card reader. 

magnetic tape/mass storage devices. 

7900 moving head disc. 

7905 moving head disc. 

instruments, 
user control word supplied in the I/O EXEC 
call (see Section III). 



When RTE-III initiates or continues an I/O operation, it 
places the addresses of the EQT entry for the device's 
controller into the base page communication area (see 
Appendix A) before calling the driver routine. 



DEVICE REFERENCE TABLE 

Logical unit numbers from decimal 1 to 63 provide logical 
addressing of the physical devices defined by the EQT (I/O 



controller) and the subchannels (if applicable) and also 
define the physical devices' (LU) status. These numbers 
are maintained in a two word Device Reference Table 
(DRT), which is created during system generation, and can 
be modified by the LU operator request (see Figure 5-1). 













word 1 n 


Subchannel No. 


LU Lock Flag 


EQT Number 


15 


14'l3 'l2 


11 


10 '9 


8 ' 7 ' 6 


5 ' 4 1 3 


2 ' 1 ' 1 


F 


Downed I/O Request List Pointer 


F (up/down flag) = if device is up word 


'7 







1 if device is down 
Figure 5-1. Device Reference Table 

DRT word one contains the EQT entry number of the 
device assigned to the logical unit, and the subchannel 
number within the EQT entry. The second DRT word con- 
tains the logical unit's status (up or down) and a pointer to 
any downed I/O requests. If the pointer is less than 64, it 
is the LU number off of which the downed I/O requests 
are queued. If several LU's point to the same device, the 
requests are queued off the lowest LU number (the major 
LU). If the pointer is greater than 64, it points to the 
device's downed I/O request list. There are separate tables 
for words one and two, with the word two table located in 
memory immediately following the word one table. The 
starting address and length of the word one table are 
recorded in the base page. The functions of logical units 
through 6 are predefined in the RTE-III System as: 

— bit bucket (null device) 

1 — system console 

2 — system disc 

3 — auxiliary disc 

4 — standard output unit 

5 — standard input unit 

6 — standard list unit 

Logical units 7 through 63 may be assigned for any func- 
tions desired although logical unit 8 is recommended to be 
the magnetic tape device. The operator can assign EQT 
numbers and subchannel numbers within the EQT entries 
to the logical unit numbers when the RTE-III System is 
generated (see Section VI), or after the system is running 
(see Section II, LU). The user determines the nu:mber of 
logical units when the system is generated. 

Logical unit numbers are used by executing programs to 
specify on which device I/O transfers are to be carri(;d out. 
In an I/O EXEC call, the program simply specifies a logical 
unit number and does not need to know which actual de- 
vice or which I/O controller handles the transfer. 
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THE INTERRUPT TABLE 

The Interrupt Table contains an entry, established at sys- 
tem generation time, for each I/O channel in the computer. 
If the entry is equal to 0, the channel is undefined in the 
system. If an interrupt occurs on one of these channels, 
RTE-III prints this message: 

ILLINTjcjc 

where xx is the octal I/O channel number. RTE-III then 
clears the interrupt flag on the channel and returns to the 
point of interruption. 

If the contents of the entry are positive, the entry contains 
the address of the EQT entry for the I/O controller on the 
channel. 

The interrupt locations in memory contain a JSB $CIC; 
CIC is the Central Interrupt Control routine which ex- 
amines the Interrupt Table to decide what action to take. 
On a power failure interrupt RTE-III halts unless the power 
fail routine is used. If privileged interrupt processing is 
included in the system, the privileged channels bypass 
$CIC and the interrupt table entirely. 



GENERAL OPERATION OF I/O PROCESSOR 

STANDARD I/O CALLS 

A user program makes an EXEC call to initiate I/O transfers. 
If the device's controller is not buffered, or in the case of 
input transfers, the calling user program is suspended until 
the transmission is completed. (See Class I/O, Section III 
for exceptions). The next lower priority program is 
allocated execution time during the suspension of a higher 
priority program. 

An I/O request (i.e.. Read, Write, Control) is channeled to 
IOC by the executive request processor. After the necessary 
legality checks are made, the request is linked into the 
request list corresponding to the referenced I/O controller. 
The parameters from the request are set in the temporary 
storage area of the Equipment Table, 

If the device's controller is available (i.e., no prior requests 
were stacked), the "initiation" section of the associated 
driver is called. The initiation section initializes the device's 
controller and starts the data transfer or control function. 
On return from the initiation section, or if the device's 
controller is busy, or a required DMA channel is not 
available, IOC returns to the scheduling module to execute 
the next lower priority program. 



If the device's controller (EQT) or the device (LU) is down, 
the calling program is automatically suspended in the 
general wait list (status = 3). While in this list the program 
is swappable, and if any LU or EQT is set up the program 
is automatically rescheduled. Refer to the ST command in 
Section II for more information on the general wait hst. 

Interrupts from the device's controller cause the Central 
Interrupt Control (CIC) module to call the "completion" 
section of the driver. At the end of the operation, the 
driver returns to CIC and consequently to IOC. IOC causes 
the requesting program to be placed back into the schedule 
list and checks for an I/O stacked request. If there are no 
stacked requests, IOC exits to the dispatching module 
(DISP); otherwise, the initiation section is called to begin 
the next operation before returning. 

POWER FAIL 

The system power fail routine, if loaded at generation, will 
perform the following steps. 

a. When power comes on, it will restart the real-time 
clock, set up a time-out entry (TO) back to its EQT, 
and then return to the power fail interrupt location. 

b. When the EQT entry times-out, the power fail 
routine will check EQT word 5 bit 14 and 15 of each 
I/O controller. The status of bits 14 and 15 will 
indicate whether the I/O controller is "down" or 
"busy." The routine will also check bit 13 of EQT 
word 4 (set by driver) which indicates if the driver is 
to process the power fail. 

c. If the I/O controller was busy when the power 
failed and the power fail bit is set when power 
resumes, the driver is entered at I. nn and the EQT is 
not reset. If the power fail bit is not set, the controller 
is set "down." The system then sets the controller 
"up," resets the EQT and enters the driver at l.nn. 

In other words, if the controller was reading or 
writing data when the power failure occurred and the 
driver is designed to handle power fail, when power 
resumes the controller driver will do the power fail 
recovery. If the controller was busy when power 
failure occurred and the controller driver is not 
written to handle power failure, the routine attempts 
to restart the I/O operation. 

d. If the controller or device was down when the 
power failed and the power fail bit is set or not set, 
when power resumes the system "ups" the device, 
resets the EQT and enters the driver at l.nn. In other 
words, if the controller or device was down when 
power failed, when power resumes the system "ups" 
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the controller and device and attempts to start the 
operation, if any, in the controller I/O request Ust. 

e. An HP supplied program called AUTOR will be 
scheduled. AUTOR will send the time of power fail- 
ure to all teletypes on the system (which re-enables 
all terminals). AUTOR is written in FORTRAN, with 
the source tape supplied so the user can easily modify 
the program to suit his individual needs. 



DRIVER STRUCTURE AND OPERATION 

An I/O driver, operating under control of the Input/Output 
Control (RTIOC) and Central Interrupt Control (CIC) 
modules of RTE-III, is responsible for all data transfer be- 
tween an I/O device and the computer. The device EQT 
entry contains the parameters of the transfer, and the base 
page communication area contains the number of the allo- 
cated DCPC channel, if required. It should be noted that 
RTE-III operation makes it manadatory that a synchronous 
device driver use a DCPC or privileged interrupt channel for 
data transfer. 

Many of the I/O drivers and subroutines are documented in 
the RTE Driver and Device Subroutine Library manuals; HP 
Part Nos. 92200-93005 and 29100-93007. 

An I/O driver always has an initiation section and usually a 
completion section. If nn is the octal equipment type code 
of the device, Ixnn and Cxnn are the entry point names of 
the two sections respectively, and DVynn is the driver 
name. As shown, the driver name is five characters long 
and starts with the characters "DV" and ends with a two- 
digit octal number (e.g., DVROO). This name is usually 
obtained from the software distribution package. The entry 
point names are four characters in length and start with 
either "I" or "C" and usually end with the same two-digit 
octal number used in the driver name. However, since the 
system generator does not examine the driver's NAM 
record, the driver may in fact be renamed to support more 
than one device. The rules for the choice of "x" and "y" 
above are as follows: 

If '>" is not "R" then "x" = >' ' 

If '>" is "R" then ";c" = "." 

Using the above rules, a driver named DVR16 has entry 
points named 1.16 and C.16. A driver named DVP16 has 
entry points IP16 and CP16. This allows one driver to sup- 
port more than one device type. 

Privileged drivers are in a special class. Refer to the end of 
this section for a discussion of privileged drivers. 



INITIATION SECTION 

The RTIOC module of RTE-III calls the initiation section 
directly when an I/O transfer is initiated. Locations EQTl 
through EQT 15 of the base page communication area (see 
Appendix A) contain the addresses of the appropriate EQT 
entry. CHAN in base page contains the number of the DMA 
channel assigned to the device's controller, if needed. This 
section is entered by a jump subroutine to the entry point, 
l.nn. The A- Register contains the select code (channel 
number) of the channel (bits through 5 of EQT entry 
word 4). The driver returns to IOC by an indirect jump 
through i.nn. 

Before transferring to l.nn RTE-III places the request 
parameters from the user program's EXEC cah into words 6 
through 10 of the EQT entry. The subchannel number is 
placed into bits 6 through 10 of word 4. Word 6, CONWD, 
is modified to contain the request code in bits and 1 in 
place of the logical unit. See the EQT entry diagram in 
Table 5-1, and Section III, Read/Write Exec Call, for details 
of the parameters. 

Once initiated, the driver can use words 6 through 1 3 of the 
EQT entry in any way, but words 1 through 4 must not be 
altered. The driver updates the status field in word 5, if 
appropriate, but the rest of word 5 must not be altered. 

FUNCTIONS OF THE INITIATION SECTION - The ini- 
tiation section of the driver operates with the interrupt 
system disabled (or as if it were disabled, in the case of 
privileged interrupt processing; see discussion of special 
conditions under "Privileged Interrupt Processing"). 

The initiation section of the driver is responsible for these 
functions (as flow charted in Figure 5-2). 

a. Checks for power fail entry by examining bit 15 
(=1 ) of EQT word 5. This bit is set only on power fail 
entry (see "b" in Power Fail). 

b. Rejects the request and proceeds to "g" if: 

1 . The device or controller is inoperable, 

2. The request code, or other of the param- 
eters, is illegal. 

c. Configures all I/O instructions in the driver to 
include the select code (and DMA channel) of the 
device's controller. 

d. Initiahzes DMA, if appropriate. 

e. Initiahzes software flags and activates the 
device's controller. All variable information pertinent 
to the transmission must be saved in the EQT entry 
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because the driver may be called for another con- 
troller before the first operation is complete. 

f. Optionally set the device's controller time out 
clock (EQT 15). 

g. Returns to RTIOC with the A-Register set to 
indicate initiation or rejection and the cause of the 
reject: 



If A = 0, 

If A= 1,2,3 
1- 

2- 
3- 

If A = 4, 



If A = 5, 



then operation was initiated. 

then operation rejected because: 
read or write illegal for device, 
control request illegal or undefined, 
equipment malfunction or not ready. 

immediate completion. (Transmission 
log should be returned in the B-Register 
in this case.) 

DMA channel required. 



DMA INITIALIZATION 
channel in two ways: 



A driver can obtain a DCPC 



a. The channel can be assigned during generation 
by entering a "D" in the driver's Equipment 
Table Entry. 

b. The driver can dynamically assign a DCPC chan- 
nel as required. 

If a driver requires DMA but does not require or use the 
DMA interrupt, the DMA control should be cleared after 
DMA initialization. Further special processing is not 
required in this case. 

If a driver requires DMA, and the DMA interrupt, special 
processing must be included in the driver. After disabling 
the interrupt system, initiating DMA and clearing control, 
the driver sets a software flag to indicate that a DMA chan- 
nel is active. 

The software flag is either the first or second word of the 
interrupt table, depending on which DCPC channel is used. 
The flag is set by making bit 1 5 equal to 1 . 

INTEL (1) - channel 1 (location 6) 
INTEL (2) - channel 2 (location 7) 

The address of INTEL is contained in the word INTBA in 
the base communication area. When bit 15 is set, the rest of 
the word must not be altered. The operation can be per- 
formed only if DUMMY is non-zero (meaning the system 
includes privileged interrupt processing.) 



DO POWER 

FAIL 
RECOVERY 




i IF A = 4 SET B = TRANSMISSION LOG RTE-C-2 

Figure 5-2. I/O Driver Initiation Section 
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The following code demonstrates these principles: 



CLF 



STC 


DMA,C 


CLA 




CPA 


DUMMY 


JMP 


X 


CLC 


DMA 


LDB 


INTBA 


LDA 


CHAN 


CPA 


= D7 


INB 




LDA 


B,I 


lOR 


= BIOOOOO 


STA 


B,I 


STF 






X EQU * 



Disable interrupts. 
Initiate DCPC channel. 

Bypass this section if DUM- 
MY = and special processing 
is not needed (go to X). 

Clear DMA control. Set B = 
address of the appropriate en- 
try in the interrupt table. 

Set bit 1 5 of the entry equal 
to 1 and return to the inter- 
rupt table. Enable interrupt 
system. 

Continue processing. 



There may be times when a driver will only occasionally 
need DMA, and thus not want to always tie up a DCPC 
channel while it is operating. This may be done in one of 
two ways: (Note that in example No. 1 , the DCPC channel 
is always assigned before the driver is entered. In example 
No. 2, the DCPC channel is assigned only if the driver 
requests it.) 

Example 1 - The DMA flag is set at generation time by 
entering a "D" in the driver's equipment table entry. The 
driver may return the DCPC channel (before completion if 
desired) by clearing the appropriate INTBL word (first or 
second word of interrupt table). This may be done as 
follows: 



LDA DMACH 


Get current channel 


LDB INTBA 


And INTBL address 


SLA 


If channel 7 


INB 


Step address 


CLA 


Clear the 


STA B , I 


Channel word 


Example 2 - The DMA fl; 


ag is not set at generati( 



above. In this case the driver is entered by RTIOC without 
a channel being assigned. The driver must analyze the re- 
quest and determine if a channel is required, and if so, 
request a channel from RTIOC by returning via I.XX,I with 
A = 5. RTIOC will assign a channel and recall the driver. 
The recall completely resets EQT words 6 through 10. 
Since it is possible for the calling program to be aborted 
between the request for DMA and the resulting recall of the 
driver, the driver must determine, independently of its past 
history, if it has DMA. The following code illustrates these 
principles: 



DLD INTBA, I 

CPA EQTl 

JMP CH6 

CPB EQTl 

JMP CH7 

LDA =B5 

JMP I . XX , I 



Come here if DMA required. 

Is channel 6 assigned? 

Yes; go configure. 

Is channel 7 assigned? 

Yes? go configure. 

No channel so 

Request one from RTIOC 



In this case the driver must also tell RTIOC that it has a 
DCPC channel at completion of request. This is done by 
setting the sign bit in the A-Register on the completion 
return to RTIOC. This bit may be set at all times - even 
when the driver does not own a DCPC channel. However, if 
set when not required, some extra overhead in RTIOC is 
incurred. The sign bit is set in addition to the normal com- 
pletion code. The following code illustrates this principle: 



LDA COMCD 
lOR =B100000 
JMP C.XX,I 



Get completion codi; 
Set the sign bit 
Return to RTIOC 



NOTE 

If your driver wishes to do a series 
of non-DMA operations, but still re- 
tain the DCPC channel assignment, 
you must clear bit 1 5 in the first or 
second word of the INTBL entry to 
prevent the system from restoring 
DMA. The correct word must be 
determined by the driver and is the 
word described in the above para- 
graphs. That is; 

INTBL (1) - channel 1 (location 6) 
INTBL (2) - channel 2 (location 7) 



Programming Hint — A driver may use the following code 
to determine which DCPC channel it is using at any time: 



DLD INTBA, I 
RAL,CLE,ERA 
RBL,CLE,ERB 

CPA EQTl 
JMP CH6 
CPB EQTl 
JMP CH7 
JMP NODMA 



Get DMA words 

Clear sign 

Bits (needed only if driver 

sets the sign bit) 

Channel 6? 

Yes 

Channel 7? 

Yes 

No — no DMA assigned 
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COMPLETION SECTION 

RTE-III calls the completion section of the driver whenever 
an interrupt is recognized on an I/O controller associated 
with the driver. Before calling the driver, CIC sets the EQT 
entry addresses in base page, sets the interrupt source code 
(select code) in the A-Register, and clears the I/O interface 
or DMA flag. The intejrupt system is disabled (or appears 
to be disabled if privileged interrupt processing is present). 
The calling sequence for the completion section is: 

Location Action 

Set A-Register equal to interrupt source code 
(P) JSB C.nn 

(P+1) Completion return from C.nn 

(P+2) Continuation or error retry return from C.nn 



The return points from C.nn to CIC indicate whether the 
transfer is continuing or has been completed (in which c^se, 
end-of-operation status is returned also). 

The completion section of the driver is flowcharted in 
Figure 5-3 and performs the following functions in the 
order indicated. 

a Checks whether word 1 (controller I/O request 
list pointer) of the EQT entry equals zero. If it does, 
a spurious interrupt has occurred (i.e., no I/O oper- 
ation was in process on the controller). The driver 
ignores the interrupt, sets EQT 15 (time-out clock) 
to zero to prevent time-out, and makes a continu- 
ation return. If not zero, the driver configures all 
I/O intructions in the completion section to refer- 
ence the interrupting controller, and then proceeds 
to "b." 

b. If both DMA and the device controller com- 
pletion interrupts are expected and the device 
controller interrupt is significant, the DMA 
interrupt is ignored by returning to CIC in a 
continuation return. 

c. Performs the input or output of the next data 
item if the device is driven under program control. If 
the transfer is not completed, the driver proceeds to 

d. If the driver detects a transmission error, it can 
re-initiate the transfer and attempt a retransmission. 
A counter for the number of retry attempts can be 
kept in the EQT. The return to CIC must be (P+2) as 
in "f." 

e. At the end of a successful transfer or after com- 
pleting the retry procedure, the following in- 
formation must be set before returning to CIC at 
(P+1): 



1 . Set the actual or simulated device 
controller status, into bits through 7 of EQT word 5. 
■ 2. Set the number of words or characters 
(depending on which the user requested) transmitted 
into the B-Register, 

3. Set the A-Register to indicate successful 
or unsuccessful completion and the reason: 

A equals for successful completion. 
A does not equal for unsuccessful: 

1 — device or controller malfunction or not ready. 

2 — end-of-tape (information). 

3 — transmission parity error. 

4 — device time-out. 

f. Clears the device controller and DMA control, if 
end-of-operation, or sets the device controller and DMA 
for the next transfer or retry. If not end-of-operation 
(i.e., a continuation exit is to be made), the driver can 
again optionally set the device controller time-out clock. 
Returns to CIC at: 



(P+1) — completion with the A and B-Registers set as 

in "e". 
(P+2) — continuation; the registers are not significant. 

I/O CONTROLLER TIME-OUT 

Each I/O controller can have a time-out clock that will 
prevent indefinite I/O suspension. Indefinite I/O suspension 
can occur when a program initiates I/O, and the device's 
controller fails to return a flag (possible hardware malfunc- 
tion or improper program encoding). Without the con- 
troller time-out, the program which made the I/O call 
would remain in I/O suspension indefinitely awaiting the 
operation-done indication from the device's controller. 
With respect to privileged drivers, the time-out parameter 
must be long enough to cover the period from I/O 
initiation to transfer completion. 

Two words, EQT 14 and EQT 1 5, of the EQT entry for each 
I/O controller function as a controller time-out clock. EQT 
15 is the actual working clock, and before each I/O transfer 
is initiated, is set to a value m, where m, is a negative num- 
ber of 10 ms time intervals. If the controller does not inter- 
rupt within the required time interval, it is to be considered 
as having "timed out." The EQT 15 clock word for each 
controller can be individually set by two methods. 

• The system inserts the contents of EQT 1 4 into EQT 
1 5 before a driver (initiation or completion section) is 
entered. EQT 14 can be preset to m by entering (T=) 
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TRANSFER NEXT 

DATA ITEM; 

UPDATE 

INDEXES; 

FLAGS, ETC. 



I 



OPTIONALLY SET 

DEVICE'S 

CONTROLLER 

TIME-OUT CLOCK 
(EOT 15) 



T 




DO TIME- 
OUT 
PROCESSING 






YES 




>^EVICE N. 
>XONTROLLER\ 




>v REQUIRED >^ 
NO 


1 r 



RETURN 
TO 
P + :2 



OPTIONALLY SET 

DEVICE'S 

CONTROLLER 

TIME-OUT CLOCK 
(EOT 15) 



UPDATE 

STATUS IN 

EOT (5) 



RETURN 
TO 
P + 2 




RE-INITIALIZE 
CONDITIONS 



(B) = # 

WORDS OR 

CHARACTERS 

TRANSFERRED 



{A) = 

COMPLETION 

CODE 



CLEAR 

DEVICE'S 

CONTROLLER 

CONTROL 



RETURN 
TO 
P + 1 



RTE-C-3 



Figure 5-3. I/O Driver Completion Section 
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m during the EQT entry phase of generation (see Sec- 
tion VI), or it can be set or modified on-line with the 
TO operator request (see Section II). 

• When the driver initiates I/O, and expects to be 
entered due to a subsequent interrupt, the driver can 
set the value m into EQT 15 just before it exits. This 
value m can be coded permanently into the driver or 
else passed to the driver as an I/O call parameter. 

NOTE 

The system always inserts the con- 
tents of EQT 14 into EQT 15 before 
entering a driver except on initia- 
tion if EQT15 is not zero, it is not 
reset. However, a time-out value in- 
serted directly into EQT 15 by the 
driver overrides any value previously 
set by the system (from EQT 14). 

DRIVER PROCESSING OF TIME-OUT 



a. The calling program is rescheduled, and a zero 
transmission log is returned to it. 

b. The LU is set to the down status, and bit 15 in 
the second word of the device's LU entry is set to 
one. An error message is printed; e.g., 

I/O TO L #;x; E #y S #z 

c. The system issues a CLC to the controller's 
select code(s) through the EQT number located in 
the interrupt table. 

Due to the system issuing a CLC to the device's select code, 
each controller interface card requires an entry in the inter- 
rupt table during generation. If an I/O card did not normally 
interrupt, and therefore did not have an entry in the inter- 
rupt table, and the controller had timed out, the system 
would not be able to issue a CLC to the I/O card. 

A time-out value of zero is equivalent to not using the 
time-out feature for that particular controller. If a time-out 
parameter is not entered, its value remains zero and time- 
out is disabled for the controller. 



A driver indicates to the system that it wants to process 
time-out by setting bit 12 in EQT word 4. The system 
never clears this bit so it need be set only once. In this 
case, when a controller times out, the following actions 
take place: 

a. Bit 1 1 in EQT word 4 is set. 

b. The driver is entered at Cnn with the A-Regis- 
ter set to the select code (from EQT word 4). 

c. The driver must recognize that the entry is for 
time-out by examining bit 1 1 of EQT word 4 and do 
whatever is necessary. The driver should then clear bit 
1 1 in the event it is entered again prior to completion 
of the operation so that it knows why it is being 
entered on the next call. (RTIOC will clear this bit 
prior to entering the driver at I.w«.) 

d. The driver may continue or complete the opera- 
tion. If it completes the operation it may set the 
A-Register to 4 to indicate time-out. 

e. If the A-Register is set to 4, RTIOC will issue 
the message. 

I/O TO L #x E #y S #z 

where x is the LU number, y is the EQT number, 
and z is the subchannel. The LU is set down. 

SYSTEM PROCESSING OF TIME-OUT 

In the case where the driver does not set bit 12 of EQT 
word 4, the following actions take place on time-out: 



DEVICE CLEAR 

If an I/O suspended program is aborted while waiting for a 
controller, the system clears the controller by sending a 
clear control request (00) to the driver. If the controller 
can be cleared without interrupt (i.e., immediately), the 
driver should return with A-Register = 2 or 4. If an inter- 
rupt is required, the driver should return with A-Register = 
0. In this latter case the system will force a 1 -second time- 
out for the controller. If the interrupt is not serviced 
before this time-out, the system will process it as in step 
"c" above. Note that the driver is not allowed to process 
this time-out. 



DRIVER AUTO UP 

A driver has the capability of automatically "uping" itself 
through a JMP instruction. For example, if a driver makes 
a not ready, parity error, EQT, or time-out return to the 
system, and subsequently detects an interrupt (or time-out) 
entry which signals that the controller is now ready, it may 
"up" itself as follows: 

JMP $UPIO 

The device's EQT and any of the EQT's downed LU's will 
be upped. If any requests are pending the system will call 
the driver -aXl.xx. 
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MAPPING SUBROUTINES FOR DRIVERS 

There are two routines supplied with the RTE-III System 
that may be called by a driver to load the User Map to 
describe a certain program. $PVMP may be called by privi- 
leged drivers and $XDMP may be called by non-privileged 
drivers. 

$PVMP SUBROUTINE (PRIVILEGED) 

The $PVMP subroutine may be called by a privileged driver 
to load the User Map to describe a certain program. This 
routine is necessary only if the privileged driver needs to 
access a buffer in a user program. This routine is a type 8 
module which means it is not re-entrant. A Type 8 module 
is loaded with each driver that calls it even though only one 
copy of the relocatable is input to RTGEN. Note that this^ 
routine should be used only by privileged drivers. 

The calUng sequence is as follows: 
EXT $PVMP 



RTN 



CONT 



EXIT 







Normal privileged entry 






Code (save registers, 






etc) 


SSM 


DMSST 


Save DMS status at 
interrupt 


LDA 


MAPAD 


Address of map 
storage area 


lOR 


SIGN 


Set sign bit indicat- 
ing store in memory 


USA 




Store user map in 
memory 


LDA 


IDADR 


Get ID segment ad- 
dress of program 


JSB 


$PVMP 


Go set user map 


SZA,RSS 




Check for error return 


JMP 


ERROR 




UJP 


CONT 


Enable user map and 
continue 

Processing for privi- 
leged interrupt 


LDA 


MAPAD 


Address of map stor- 
age area 


USA 




Restore original map 


JRS 


DMSST RTN 


Restore DMS status 
at interrupt and 
continue 



Restore registers and 
memory protect 
status then return to 
point of interrupt 



MAPAD 



MAPAD 


DEF 


MAP 




MAP 


BSS 


32 


Map save area 


SIGN 


OCT 


100000 




IDADR 


BSS 


1 


Storage for ID seg- 
ment address 


DMSST 


BSS 


1 


Storage for DMS 
status at interrupt 



$PVMP will check to see if the program is resident in mem- 
ory. If it is not, the User Map will not be reloaded and the 
A-Register will be zero on return. If the program is resident, 
the User Map will be loaded and the A-Register will be non- 
zero on return. Note that any privileged driver using this 
routine must save the contents of the User Map before call- 
ing this routine and must restore the contents before return- 
ing to the point of interrupt. 

$XDMP SUBROUTINE (NON-PRIVILEGED) 

The $XDMP subroutine may be called by a non-privileged 
driver to load the User Map to describe a certain program. 
Since the system will enter the. driver with the map enabled 
which describes the buffer of the current I/O call, this 
routine is necessary only for those drivers which must access 
another buffer which is contained in a user program. Note 
that this routine is intended for the use of non-privileged 
drivers only and is included as part of the system. The calling 
sequence is as follows: 



EXT 



$XDMP 







Normal driver proc- 






essing 


ilSA 




Get DMS status 


RAL,RAL 




Position current 
status in upper bits 


STA 


DMSST 


Save status for later 


LDA 


MAPAD 


Address of map 
storage area 


lOR 


SIGN 


Set sign bit indicat- 
ing store in memory 


USA 




Store user map in 
memory 


LDA 


IDADR 


Get ID segment ad- 
dress of program 


JSB 


$PVMP 


Go set user map 


SZA,RSS 




Check for error 
return 


JMP 


ERROR 
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UJP 



CONT 



CONT 



EXIT 



LDA 

USA 
JRS 



MAPAD 



DMSST 



NXT 



MAPAD DEF 
MAP BSS 



SIGN 
IDADR 



OCT 
BSS 



DMSST BSS 



MAP 

32 
100000 

1 
1 



Enable user map and 
continue 

Process buffer under 
User Map 
Address of map 
storage area 
Restore original map 
NXT Restore earlier 
DMS status and 
continue 

Proceed with normal 
processing 



Map storage area 

Storage for ID seg- 
ment address 
Storage for DMS 
status 



The routine will check to see if the program is resident in 
memory. If it is not, the User Map will not be reloaded, and 
the A-Register will be zero on return. If the program is 
resident, the User Map will be reloaded and the A-Register 
will be non-zero on return. 

Note that any driver using this routine must save the con- 
tents of the User Map before caUing this routine and must 
restore the contents before exiting. 

It is recommended that privileged drivers be designed for 
user communication through common or subsystem global. 
If this is done, the driver does not have the overhead of 
map switching; it simply saves and restores the state of the 
machine (including DMS status). 

SAMPLE I/O DRIVER 

The sample driver in Figure 5-4 demonstrates the principles 
involved in writing an I/O driver for the RTE-III System. 
Note that this driver is for tutorial purposes only and not one 
of the drivers suppUed with the system. 
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t.NT I,7H,C,7l^ 



H&i,e. .n>i^^' it-i *» f, I Fxfr.C OWlvtfy <;?»> &,P,K, (OUTPUT) ** 



'I if' ••^ 1 A S ^^ d , K , L 

/ Mil d * 

V1 V*! VC; J * 

i^ k- ii 8 * 

0^C^9* l)kIvEt< 74? Ot^tKATfr-.S UMUE*^ THfc COMKOL 0^ THE 

;^M1«* l/n CCiNTKOL MfiDiJU. 0^ THE kfcAL-TlME EXELUTIVE. 

15^11* THIS Of^lvt^ lb WtbPONcilt^LE KDK CONlkOLLlNG 

C^f'l*?* LUJTPdT T^ANjS*^ISSjtlN TO A 16 >3 1 T EXTERNAL 

M013* DtVlft. <7^> 15 THE EUUIPMENT TYPfc. COUE ASSIGNED 

et'U* GENERALLY TO THhSt UEvlCFS. l,7\A IS THfc 

^^,lb* ENThY P(>1mT E[iK the *INITIATIUNJ* bEuTiON ANU C,70 

t^l^l6* IS THE *COMPLtTlUN* SECTION Ei^TWY, 



Figure 5-4. Sample I/O Driver 
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w\7 * 

..^. lb* 

,,',,^l9* , Tht iNlTTATlLlr-^ bLLTlUN IS CAtLtU ekOM I/O 

^t":^^* CCNTPUL U. INITIAlIZH a OLVlCt AMD iMTlATt 

:yv'2\* AN iHiTPUr OPhWATI'.'N, 

ti / i" 2 * 

vl^',2s5* I/O CnNTWOU SETS rHF AOl)»tSS QF EACH i^ORD OF THt 

^H24* lb WQKO h'jT bNTKY fFUK 1 Ht Ot^lZt) IN ThE SYSTtM 

i^^2b* CO^MUNICAT I(iMS AREA FUR BOTh IMTIATOR AND CnNTINUATOW 

«026* StCIIONii. THE u^^lVEW REFtWtNCES TO THE FQT Af^E: 

C1!^2/* -bUTl THWL) EgTlS- 

i^ l'. ? 8 * 

*^ ■/ 2 9 * C A L L I N ti S t, I J U £ M C E : 

^n^-il* (A) = SEUeCT CUUi: OF THE I/O DfcVlCt. 

i;i^>32* P JSb l,7v^ 

(.^33* P + 1 -RETURN- 

f^(^34* 

vO C^ 3 3 * 

^^36* (A) s <^, OPERATION INITIATED 

'/){?37* (A^ s REJECT Cr3ijE 

t^038« 

■/t',39* 1, ILLEGAL REQUEST 

0fi40* 2. ILLEGAL MODE 

^041* 

0W42* -THE COMPLETION SECTION IS CALLED BY CENTRAL 

0H43* INTERRUPT CONTROL TO CONTINUE OR COMPLETE 

'/)tM4* AN OPERATION, 

i;i(^45* 

0v^46* CALLING Sequence: 

0t^47* 

(7li54H* (A3 s SELFCT CODE OF THE I/O DEVICE. 

i3 1^ 4 9 * 

iivJOfl* P JSB C,7t^ 

0(^S1* P*l -COMPLETION RETUWN- 

^,^52* P + 2 CONTINUATION RETURN- 

l/)l^b3* 

C^^1b4* (A) s 'A, SUCCESSFUL COMPLETION WITH 

0ti55* (B) = « OF WORDS TRANSMITTED, 

00b6* lA) a 2, TRANSMISSION ERROR DETECTED 

0(^57* Ca), SAME AS FOP (A)sp) 



PAGE C'/^^3 tiHl ** RT EXkC uKlVER </f'> G . P , K ., (OUTPUT) ** 



'/ f' b * 

./,^.3y* • CONTINUATION RtTiiPN; REGISTERS 

;^^1b^'.* kEAnInGLES.s 

(/) b 1 * 

kii'-ft2* -RECOkO f-ORMAT- 

C^ (^j b 3 tk 

^^•,64* THIS DKlVtw PROvlOtS A \t BIT BINARY 

v'!v-bt)* WURU TRANiSFtR ONLY, 



Figure 5-4. Sample I/O Driver (continued) 
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PAGE 0004 tt^\ < DRIVER 76) *INITIATION* SECTION > 

0067* *** INITIATION SECTION *♦* 
0068* 

0069 00000 000000 1,70 NOP Entry from ioc 

0070* 

0071 00001 016071R JSB SETIO SET I/O INSTRUCTIONS FOR OEVICF 
0072* 

0073 00002 161665 LUA EQT6,I GET CONTROL WORD OF REQUEST, 

0074 00003 012l0bR AND sbS ISOLATE, 
0075* 

0076 00004 052106R CPA sBl IF REQUEST IS FOR INPUT 

fdd77 00005 126000R JMP 1,70,1 THEN REJECT, 

0078 00006 052107R CPA «B2 PROCESS FOR WRITE REQUEST 

0079 00007 026012K JMP D.Xl GO TO WRITE REQUEST 
0080* 

0081* REQUEST ERROR- CAUSE REJECT RETURN TO I/O CONTROL. 
0082* 

0083 00010 062107R LDA .82 SET A«2 FOR ILLEGAL CONTRL REO, 

0084 00011 126000R JMP 1,70,1 -EXIT- 
0085* 

0086* WRITE REQUEST PROCESSING 
0087* 

0088 00012 161666 D.Xl LUA EQT7,1 GET REQUEST BUFFER ADDRESS 

0089 00013 171670 STA EQT9,I AND SET AS CURRENT ADDRESS 

0090 00014 161667 LUA EUTb,! GET BUFFER LENGTH 

0091 00015 003004 CMA,INA SET NEGATIVE AND SAVE 

0092 00016 171671 STA EQT10,I AS CURRENT BUFFER LENGTH, 

0093 00017 002002 SZA CHECK LENGTH 

0094 00020 026024R JMP D,X3 NON.-ZtRO 

0095 00021 062n0R LDA »B4 IMMEDIATE COMPLETION 

0096 00022 0w640(^ CLB SET TLOG IN B-REG 

0097 0&1023 126000R JMP 1,70,1 IF 2EKU 
0098* 

0P99* CALL COMPLETION SECTION TU wRITh FIRST WORD, 
0100* 

0101 M0024 062104R 0,X3 LDA P^ ADJUST RETURN 

0102 00025 072031W STA C,70 TO INITIATOR SECTION, 

0103 00026 026030-^ JMP n,X2 GO TO COMPLETION SECTION 
0104* 

0105 M0027 0^^2401^ lEXIT CLA RETURN TO I/O CONTROL WITH 

0106 00U130 126000R JMP 1.70,1 OPERATION INITIATED. 
0107* 



Figure 5-4. Sample I/O Driver (continued) 
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PAGE «fe)i?)5 tt(?il < DRIVER 70 *COMPUETION StCTION* > 



0109* 

0110* 

P91U* 

0112 

0113 

0114 

0115 

0116 

01 17* 

0118 

0119 

0120 

0121* 

0122 

i!ll23 

0124 

0125 

0126 

0127* 

0128* 

0129 

0130 

0131 

0132 

0133* 

0134 

0135 

013b* 



*** COMPLETION SECTION *** 



(;t003i 

00032 
00033 
00034 
00035 

00036 
00037 
00040 

00041 
00042 
00043 
00044 
00045 



00046 
00047 
00050 
0i^051 

00052 
00053 



000000 

165660 
006003 
026051R 
016071R 

002400 

151671 

026054R 

165670 
135670 
160001 
135671 

000000 



102600 
103700 
05^:200 1 
175774 

036031R 
126031R 



C.7 



D.X2 



1,1 
1.2 

SPU^vI 



NOP 

LDB ECITUI 

SZ8,RSS 

JMP SPURI 

JSB StTIO 



CLA 
CPA 
JMP 

LOB 
ISZ 
UDA 
ISZ 
NOP 



OTA 
STC 
kSS 
STB 

ISZ 

JMP 



EHT10, I 
1.3 

EQT9,I 
EUT9,I 
B,I 
EOT 10, I 





0,C 



ENTRY 
SPURIOUS 

INTERRUPT? 
YES - IGNORE 
SET I/O INSTRUCTIONS FOR DEVICE 

IF CURRENT BUFFER LENGTH a 0, 
THEN, GO TO 
STATUS SECTION, 

GET CURRENT BUFFER ADDRESS 

ADO 1 FOR NEXT WORD 

GET WORD 

AND INDEX WORD COUNT 

IGNORE P+1 IF LAST WORD, 



OUTPUT WORD TO INTERFACE 
TURN DEVICE ON 



tQTl5,I ZERO IIME-OUT CLOCK WO«D 

C,70 ADJUST RETURN TO P+2 
C,70,I -EXIT- 



Figure 5-4. Sample I/O Driver (continued) 
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^1^9* STATUS AND COMPLtTION SfcCTlON. 

^141 i«(^0b4 lk:!2b?? I,vS UIA GET STATUS WORD 

0142 «0£^5f) i^lPlllH AND »B77 STRIP OFF BITS 

0143 C^Pl05e> ti/06',m STA B AND SAVE IN B 

0144 «i^C957 lblb64 LDA EQTb,! REMOVE PREVIOUS 
^14b 0t^P!60 01?112R AND «dl7740M STATUS BITS 
>?l4b Pik)061 030V)01 lOR B SET NEW 

0147 00062 171664 STA EQTb,! STATUS BITS 

0148* 

•3149 00063 002400 CLA SET NORMAL RETURN COND 

0150 00064 0b6n0R CHB sB4 ERROR STATUS BIT ON? 

1^151 00065 0b2107R LOA »B2 YES, SET ERROR RETURN 

0152* 

0153 00066 165667 LOB EQTH,1 SET (b) » TRANSMISSION LOG 
0154* 

0155 00067 106700 1.4 CLC CLEAR DtVlCE 

0156* 

(7)157 00070 126031R JMP C,70,l -EXIT FDR COMPLETION 

0158* 

0159* 

0160* SUBROUTINE <SETIO> CONFIGURES I/O INSTRUCTIONS, 
0161* 

0162 000/1 000000 SETIO NOP 

0163 00072 032103R lOR LIA COMBINE LIA WITH I/O 

0164 00073 0/20b4R STA 1.3 SELECT CODE AND SET, 
0165* 

0166 00074 042113R ADA aB100 CONSTRUCT OTA INSTRUCTION 

0167 00075 072046R STA 1,1 
51168* 

t^l69 00076 042114R ADA bB1100 CONSTRUCT STC,C INSTRUCTION 

0170 00077 072047R STA 1,2 

0171* 

0172 00100 032llbR lUR =84000 CONSTRUCT CLC INSTRUCTION 

0173 00101 072067R STA 1,4 
0174* 

0175 00102 126071R JMP SETIO,! -RETURN- 
0176* 



Figure 5-4. Sample I/O Driver (continued) 
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PRIVILEGED INTERRUPT PROCESSING 

Wlien a special I/O interface card is included in the system, 
RTE-III allows a class of privileged interrupts to be processed 
independently of regular RTE-III operation, with a minimal 
delay in responding to interrupts. The presence and location 
of the special I/O card is selected at system generation time. 
Its actual hardware location is stored in the word DUMMY 
in base page (or if not available, zero). See the generation 
section for the exact specification procedure. 

The special I/O card physically separates the privileged 
interrupts from the regular system-controlled interrupts. 
When an interrupt occurs the card has its flag set which 
enables the card to hold off non-privileged, lower priority 
interrupts. This means that the system does not operate 
with the interrupt system disabled, but in a hold-off state. 
Furthermore, the privileged interrupts are always enabled 
when RTE-III is running, and can interrupt any process 
taking place. 

The privileged interrupts are processed in two ways: 

a. Through a privileged driver which has in general 
the structure of a standard I/O driver plus a special 
privileged interrupt processor routine. 

b. Through a special routine located (embedded) 
in the system area. 

If a privileged driver is used, the calling program can make a 
standard I/O call to the privileged device. The calling program 
will be suspended for the time it takes to do the transfer, 
after which it will be rescheduled. To the calling program, 
there is no difference between a privileged type device I/O 
call and a non-privileged (standard) type device I/O call. If 
the privileged driver is assigned a time-out parameter, the 
parameter must be long enough to cover the period from 
I/O initiation to transfer completion. 

If a special routine is used, a jump subroutine indirect (JSB 
xxx,I) instruction in the interrupt location (set by using 
"ENT,name" when configuring the interrupt table) channels 
the special interrupt directly to the entry point of its associ- 
ated special routine. CIC and the rest of the system are not 
aware of these interrupts. but CPU time is lost because of 
them. For this reason the special routine must functionally 
be completely independent of the system (i.e., the routine 
can not use any of the system functions). CIC sets a software 
flag (MPTFL) in base page indicating the current status of 
the memory protect fence. 



If MPTFL equals zero, memory protect was "ON" at the 
time of interrupt. Any special interrupt routine must restore 



the status of memory protect and the dynamic mapping 
system as described below before returning to the point of 
interruption by a JMP xxx,I instruction. 

IF MPTFL equals one, RTE-III itself was executing when 
the privileged interrupt occurred, and memory protect was 
"OFF". The special routine must not restore memory pro- 
tect in this case. 



MEMORY ACCESS BY PRIVILEGED INTERRUPT 

A privileged interrupt routine, whether embedded directly 
within the system or within a privileged driver, must save 
and restore all registers which are used (including index 
registers), restore memory protect to its original state (word 
MPTFL contains this status), and restore the status of the 
Dynamic Mapping System. If the privileged driver wants to 
access a buffer within a disc resident program, the User 
Map will have to be saved and restored. In addition, it will 
have to be loaded to describe the correct partition. How- 
ever, if the driver limits its access to a buffer in either com- 
mon or the subsystem global area, the driver may access 
that buffer while in the System Map if the generation 
option to include common and SSGA in the System Map 
was exercised. That is, if the program the driver is servicing 
puts a buffer in the common area, then the driver can 
access that data through the System Map which is enabled 
by the interrupt. Note that no standard HP software uses 
common; it is reserved for the user. 



SPECIAL PROCESSING BY CIC 

The Central Interrupt Control (CIC) module is entered on 
all normal (non-privileged) interrupts. CIC disables the 
entire interrupt system (including privileged), saves registers, 
issues a clear flag instruction (CLE) to the interrupt location, 
sets the memory protect "OFF" (MPTFL=1), and checks 
the DUMMY word. If the DUMMY word is zero, the hard- 
ware interrupt system is left disabled and normal processing 
continues. If non-zero, a set control instruction (STC) is 
issued to the I/O location specified (this assumes that the 
flag on the special I/O card is set). The STC holds off lower 
priority interrupts until the control flip-flop is cleared on 
the special card. 

If DUMMY is non-zero, CIC also clears the control flip-flop 
on each DCPC channel to defer DMA completion interrupts, 
and enables the interrupt system (a NOP in the interrupt 
location for the special card causes its interrupts to be 
ignored). The DMA transfer itself is not affected, only the 
completion interrupt. 
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Interrupt processing continues and control is passed to a 
driver, timer routine, scheduler, or other appropriate execu- 
tive module. Privileged interrupts can occur during this 
processing. RTE-III returns to user program processing 
through the interrupt return module, $IRT. 

$IRT briefly disables the entire interrupt system. Each 
active DCPC channel is reset (STC) to allow it to interrupt. 
User register values are restored, and the memory protect 
system is inactivated. The User Map is enabled and control 
is transferred to the user program with the interrupt 
system on. 



PRIVILEGED INTERRUPT ROUTINES 

A privileged interrupt routine, whether embedded directly 
within the system or within a privileged driver, must save 
and restore all registers which are used (including index 
registers), restore memory protect to its original state, and 
restore the status of the Dynamic Mapping System. The 
privileged interrupt routine must not use any features or 
requests of RTE-III, or either DCPC channel. It can com- 
municate with normal user programs by use of the appro- 
priate common region. Flags, parameters, control words, 
etc., can be set and monitored by either routine in the pre- 
defined locations in common. The starting address of the 
common region is available in base page. (See Appendix A.) 
A normal user program could, for example, be scheduled to 
run at periodic time intervals to scan and set indicators in 
common, and fill or empty buffers in that area. 

SAMPLE PRIVILEGED DRIVER 

The following discussion describes a sample privileged driver 
(see Figure 5-5), generalized to DVRXX, which is controlling 
a device operating in the privileged mode. The user buffer 
is in common. 

The device transfers one word of data each time it interrupts, 
and the data is stored into the buffer passed to the driver via 
the call parameters. Also passed to the driver is the number 
of data words to be input from the privileged device, this 
being the length of the data buffer. 

The concepts behind such a driver are as follows: 

• It is called by a standard EXEC 1/0 call. 

• The caUing program is placed into I/O suspension. 

• The device controller's trap cell is changed from 
"JSB CIC" to "JSB P.XX" where P.XX is the entry 
point to the privileged routine within the driver. 
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• Therefore, each time the device's controller inter- 
rupts, the RTIOC overhead is circumvented because 
the privileged routine is entered directly. 

• After each interrupt, if another data point is still 
required to satisfy the buffer length, the device's 
controller is again encoded to subsequently inter- 
rupt, and the privileged routine is exited. 

• Wlien the entire data buffer has been filled, the driver 
needs a way to communicate to the Executive that 
the transfer is complete. This is accomphshed by 
allowing the driver to time-out. The time-out causes 
RTIOC to re-enter the driver at C.XX. 

• C.XX returns the transmission log, via the B-Register, 
and a successful completion indication, via the 
A-Register, to RTIOC. 

• RTIOC then reschedules the program which called 
the driver through its normal I/O completion machin- 
ery. 

A standard RTE-III driver uses the EQT for all its tempor- 
ary storage so that the same driver can be driving more 
than one device controller simultaneously. A privileged 
driver, however, cannot do this because it can never know 
the state of pointers to the EQT while it is running since 
it is running independently of the Executive. The 
privileged driver keeps its temporary storage internally, 
and therefore can control only one device controller. For 
each device controller the driver will control, the driver 
must be reassembled with all names DVRXX and $JPXX 
(for this example) changed to another number. Then one 
driver per device controller must be loaded into the 
system at generation time. 

INITIATION SECTION, I.XX. Refer to the partial hsting 
of the sample privileged driver in Figure 5-5. A standard 
I/O call to input from the device controller causes the 
calling program to be I/O suspended and the driver to be 
entered at I.XX. The request code is checked for validity. 

Because this driver can control just one device controller 
(unlike standard drivers), there is no need to configure it 
more than once. Therefore, the first time the driver is 
entered, it is configured and the switch at "FIRST" is 
cleared so that on all subsequent entries the configuration 
code is not executed. 

The modification of the device controller trap cell is per- 
formed just once, after the configuring routine, and is not 
modified again on all later entries into the initiator. The 
trap cell is altered so that the device controller interrupts 
will be channeled to the P.XX subroutine instead of to 
RTIOC. The "JSB P.XX" instruction and its associated 
base page link are established via the small program 
"$JPXX" (see listing). 



Real-Time Input/Output 



A counter, which is incremejited in routine P.XX, is estab- 
Hshed for the number of readings to be taken; the buffer 
address for the storage of the data is saved, and the device 
controller is set up to initiate a reading and is encoded. The 
initiator then exits. 

PRIVILEGED SECTION, P.XX. When the device con- 
troller interrupts, P.XX is entered as a result of the 
controller's trap cell modification. The system Map will 
be enabled by the interrupt. 

Because entry is made directly into P.XX the routine must 
do the housekeeping which RTIOC does when entered from 
an interrupt. Before P.XX can turn the interrupt system 
back on for higher priority interrupts, it must ensure that 
the DMA channels cannot interrupt, save the old memory 
protect status, and set its new status. It must also save the 
dynamic mapping system status at the time of interrupt. 

P.XX then loads and stores the data in the next unfilled 
buffer word. If there is yet another data point to be taken, 
P.XX sets up the device controller for the next reading, 
disables the interrupt system, encodes the device controller, 
restores memory protect status and its flag, turns the inter- 
rupt system back on, and exits. This basically resets the 
system to its state before P.XX was entered. 

When the last reading is taken, P.XX disables the interrupt 
system, turns off the device controller, and sets up the 
driver for an immediate time-out. Before P.XX exits, it 
restores memory protect status and its flags, turns the 
interrupt system back on and restores the dynamic 
mapping system status. 

COMPLETION SECTION, C.XX. The status of the device 
controller and the driver is now unchanged until the TBG 
interrupts. The TBG interrupt will cause a time-out (this is 
because - 1 is set in EQT word 15), which will cause RTIOC 
to pass control to C.XX which returns a transmission log 
and a normal completion indication to RTIOC. 

RTIOC then goes to its I/O completion section which 
reschedules the calling program and processes the controller 
request list as if it were a standard (non-privileged) 
controller. 

ACCESS TO BUFFER IN USER AREA 

If the sample privileged driver described above were written 
to access a buffer within the user program area instead of 
common, the following changes would be necessary: (The 
caution note on the sample also applies here, since informa- 
tion is stored in the driver). 



I.XX - The ID segment address of the calling program 
would have to be saved. This would be done as follows: 



I.XX STA SCODE 
LDA 1717B 

STA IDADR 



Save select code 
Get ID Segment 
address 
Save it 



P.XX - In addition to saving and restoring the DMS 
status, the User Map would have to be saved, reloaded 
to describe the user, and restored on exit. This would 
be done as follows: 

P.XX 



P.XI SSM DMSTS 

LDA MAPAD 

lOR SIGN 

(37A(SEC) USA 

LDA IDADR 

(lOOjuSEC) JSB $PVMP* 

UJP CONT 

CONT LDA MPTFL 



EXITl 



MP ADR 

IDADR 

MAP 
DMSST 

SIGN 



LDA MAPAD 

USA 

LDA EOSV 



DEF MAP 

BSS 1 

BSS 32 

BSS 1 

OCT 100000 



Save DMS status 
Get address of map 
storage area 
Set sign bit indicating 
store to memory 
Save user map 
Get ID segment ad- 
dress 

Call routine to set 
map 

Enable user map and 
jump to CONT 



Get address of map 
storage area 
Restore user map 



Address of save 

Map area 

Save ID segment 

address 

Save map area 

Save DMS status 

Sign Bit 



The subroutine $PVMP is a Type 8 subroutine and is loaded 
with each driver that accesses it. It is not re-entrant. 

The times given in the example are approximate. 
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T«00i!i04 18 ON CRei0002 USING 00023 B^KS RI0203 

* 

* DRIVER WITH PRIVILEGED INTERRUPT 

* 

NAM DVRXX 

ENT I, XX, P, XX, C, XX 

EXT SJPXX 

* 
* 

* CALLING SEQUENCE! 

* JSB EXEC CALL EXEC 

* DEF **5 RETURN POINT 

* DEF RCODE REQUEST CODE 

* DEF CONWO CONTROL WORD 

* DEF BUFFR ADDRESS OF BUFFER 

* DEF LENTH LENGTH OF BUFFER 
* 

* 
* 
* 

* CAUTION! THIS DRIVER WILL NOT WORK WITH MORE THAN 

* ONE SUBSYSTEM, IF MQRE THAN ONE SUBSYSTEM 

* EXISTS IN A SYSTEM, BOTH DVRXX AND SJPXX MUST 

* BE RE-ASSEMBLED WITH ALL THE NAMES CONTAINING 

* 'XXI CHANGED TO SOME OTHER NUMBER, THEN ONE 

* DRIVER PER SUBSYSTEM MUST BE PUT INTO THE SYSTEM 

* AT GENERATION TIME, 
* 

* INITIATION SECTION 

* 

1,XX NOP 

STA SCOOE SAVE SELECT CODE 

LDA EQT6,I REQUEST CODE TO A 

AND M77 

CPA bBi READ REQUEST? 

JMp **3 yts 
f^EJCT CLA.INA NO - ERROR 

JMP I, XX, I REJECT RETURN 

''If^ST RSS CONFIGURE FIRST 



JMP INIT TIME ONLY 

LDA SCODE 

lOR LIA CONFIGURE 

STA 100 10 INSTRUCTIONS 



LDA 


SJPXX 


SET TRAP CELL TO 


STA 


SCODE, I 


JSB P,XX 


LDA 


EQT4,I 


CLEAR EQT4 BIT12 


lOH 


8IT12 


TO ALLOW NORMAL 


XOR 


BIT12 


TIME OUT, 


STA 


EQT4,I 




LDA 


EQT15 


SAVE EQT15 


STA 


EQ15 


AND EQT4 ADDRESSES 



Figure 5-5. Sample Privileged I/O Driver 
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tOA EQT4 


FOR LATER, 






STA EQ4 








CIA 


SET SO AS NOT TO 






STA FIRST 


CONFIGURE AGAIN 




* 
INIT 


LDA EQT8, I 


NUMBER OF CONVERSIONS TO 


A 




CHA,INA 


NEGATE FOR 






STA CVCTR 


CONVERSION COUNTER 






5SA,RSS 


REJECT IF 






JMP REJCT 


NUMBER *»0 






LDA EQT7,I 


SAVE DATA BUFFER 






STA DAPTR 


ADDRESS FOR P.XX 






JSB READ 


START A READING 




101 


STC 10, C 


ENCODE DEVICE 






JMP I. XX, I 


RETURN 




READ 


NOP 


ROUTINE CONTAINING 






ft 


CONFIGURED 10 






• 


INSTRUCTIONS TO 






m 


SET UP THE DEVICE 






JMP READ, I 


TO INITIATE ONE READING 




* PRIVILEGED INTERRUPT ROUTINE 




P,XX 


NOP 








CUF 


TURN OFF INTERRUPTS 






cue 6 


TURN OFF 






CLC 7 


DMA INTERRUPTS 






STA ASV 


S 






STB BSV 


A 






ERA,AtS 


V 






SOC 


E 






INA 








STA EQSV 


REGISTERS 






STX XSV 


SAVE INDEX 






STY YSV 


REGISTERS 




P. XI 


SSM DMSTS 


SAVE DMS STATUS 




CONT 


IDA HPTFt 


SAVE MEMORY 






STA MPFSV 


PROTECT FLAG 






CLA.INA 


TURN OFF MEMORY 






STA MPTFl 


PROTECT FLAG 






STF 


TURN ON INTERRUPTS 




* 


• 


LOAD IN DATA 






f 


FROM DEVICE 






■• 


VIA 10 INSTRUCTIONS 




* 


STA DAPTR, I 


STORE IN DATA BUFFER 






ISZ CVCTR 


LAST CONVERSION 






RSS 


NO 






JMP DONE 


YES 






ISZ DAPTR 


SET UP FOR 






J3B READ 


NEXT CONVERSION 






CUP 


TURN OFF INTERRUPTS 




104 


STC 10, C 


ENCODE DEVICE 




EXIT 


LDA MPFSV 


MAS MEMORY 






SZA 


PROTECT ON? 






JMP EXITl 


NO, FORGET DMA'S 






LOB INTBA 


TURN 





Figure 5-5. Sample Privileged I/O Driver (continued) 
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IDA B,l 


DMA'S 




SSA 


BACK 




STC 6 


ON 




INB 


IF 




IDA B,I 


THEY 




SSA 


WERE 




STC 7 


ON 


EXITl 


UOA EOSV 


RESTORE 




CLO 


E AND 




SLA.ELA 







8TF I 


FLAGS 




COB BSV 


RESTORE B 




UOX XSV 


RESTORE INDEX 




LDY Y8V 


REGISTERS 




IDA MPFSV 


RESTORE MEMORY PROTECT 




STA MPTFL 


FLAG IN SYSTEM 




SZA 


MEMORY PROTECT ON? 




JMP EXIT2 


NO 




JRS DMSTS EXl 




EXl 


LDA ASV 


YES, RESTORE A 




STF 


TURN ON INTERRUPTS 




STC 5 


SET MEMORY PROTECT 




JMP P. XX, I 


RESTORE DMS 


* 




STATUS AND 


* 




RETURN 


EXIT2 


IDA ASV 


RESTORE A 




STF 


TURN ON INTERRUPTS 




JRS DMSTS P,XX,I RESTORE DMS 


* 




STATUS AND 


* 

* 




RETURN 


DONE 


CIF 


TURN OFF INTERRUPTS 


107 


cue 10 


TURN OFF DEVICE 




CCA 


SET TIME OUT FOR 




STA EQl5,l 


ONE TICK AND SET 




IDA EQ4,I 


BITJ2 IN EQT4 SO 




lOR BIT12 


RTIOC WILL CALL 




STA E04,I 


C.XX ON TIME OUT, 


* 


JMP EXIT 


00 TO EXIT 


* 

* COMPUETION SECTION 


* 
CXX 


NOP 






CUA 


SET UP FOR NORMAL RETUI 




LDB EQT8,I 


TRANSMISSION LOG TO B 




JMP CXX, I 


RETURN 



* CONSTANTS AND TEMPORARIES 



SCODE 
CVCTR 


OCT 
OCT 

t 






LIA 
M77 
OAPTK 


• 

LIA 
OCT 
OEF 




n 





Figure 5-5. Sample Privileged I/O Driver (continued) 
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ASV 


OCT 





BSV 


OCT 


9 


EOSV 


OCT 





MPFSV 


OCT 


^ 


EQ4 


NOP 




EQIS 


NOP 




BIT12 

* 


OCT 


I00e»0 


* SYSTEM 


COMMU 


• 


EOU 


1650B 


INTBA 


EQU 


,♦4 


EQT4 


EQU 


• ♦11 


EQT6 


EQU 


,♦13 


EQT7 


EQU 


• ♦14 


EQT8 


EQU 


.♦IS 


EQT15 


EQU 


1774B 


XA 


EQU 


• ♦49 


X8 


EQU 


,♦50 


XEO 


EQU 


,♦51 


MPTFL 


EQU 


,♦80 


A 


EQU 





B 


EQU 
END 


I 



AREA 



JIMa3 TsHHtlfi4 IS ON CWC^dli^S USINC7 (?)«t^Ml BLKS R = 0l^t^0 

■/t^e>l ASMb,H,L,b 

f^t^t^^i ENT SJHXX 

>50W5 tJPXX JSb P. XX 

/ ti '/ b t ^ 



Figure 5-5. Sample Privileged I/O Driver (continued) 
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SECTION VI 
RTE SYSTEM INSTALLATION 



The RTE-III system is initially configured with the system 
off-line generation program RTGEN. For instructions on 
using the RTE On-Line Generator see RTE-II/III On-Line 
Generator Reference Manual (92060-90016). Configuration 
is accomplished by the user entering answers in response to 
questions from RTGEN. This section describes the steps 
necessary to produce such answers. 

To facilitate system generation, this section has been divided 
into three parts. 

• Part 1 — Planning. This part contains directions for 
planning or laying out an RTE-III System. The overall 
structure of the system, including I/O and memory 
configuration, is planned with the aid of worksheets. 
It is imperative that the user be familiar with Section I 
of this manual before planning the system. 

• Part 2 — Procedure. This part converts the plans from 
Part 1 into a procedure used to prepare generator res- 
ponses to configure the system. The procedure is out- 
lined on worksheets in the form of questions from 
RTGEN and responses by the user. 

• Part 3 — Operation. This part presents the operation of 
the generator including features making the process more 
convenient. A sample generator is presented and dis- 
cussed step-by-step (the sample is based on the generation 
Usting in Appendix C). The last step in this part is the 
initialization (or start-up) of the new system. 

DESCRIPTION 

RTE-III is a multiprogramming system using partitions 
which are numbered contiguous blocks of memory the size 
and number of which are fixed during generation. The basic 
purpose of the generation is to build a system structured as 
shown in Figure 6-1. During the generation, various pro- 
gram modules are loaded and questions answered. The 
memory resident parts of the system are constructed and 



stored on the disc. The remainder of memory is divided 
into partitions for disc resident programs and these pro- 
grams are relocated and saved on the disc to be swapped into 
memory when needed. The relocatable subroutine library 
is saved on disc for use by programs relocated during normal 
system operation. 



DISC RESIDENT PARTITION m 
BASE PAGE 



DISC RESIDENT PARTITION 1 
BASE PAGE 



SYSTEM AVAILABLE MEMORY 



MEMORY RESIDENT PROGRAMS 



BG COMMON 
RT COMMON 



I 



COMMON 



SUBSYSTEM GLOBAL AREA 



I 



MEMORY RESIDENT LIBRARY 



SYSTEM 



SYSTEM BASE PAGE 



HIGH MEMORY A 



Z PAGES 
Z=N- Y -X 



MINIMUM SIZE 
APPROXIMATELY 
12 PAGES (X) 

LOW MEMORY 



Figure 6-1 . Physical Memory Allocations 



Be aware that certain software subsystems may have specific 
requirements when included in the system generation. Op- 
tions in such areas as spooling, measurements, communica- 
tions, and multiple terminal operation may place specific 
requirements on I/O configuration, buffer space, etc. As an 
example, refer to the Batch and Spool Manual (HP Part No. 
92060-90013) when planning for that subsystem. 
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PART 1 
Instructions for Planning RTE 



This planning part has been divided into three major areas 
as follows: 

• Disc Planning — Disc tracks are grouped together to form 
subchannels. A scratch (work) area is set aside to tem- 
porarily hold programs during the generation process. 
Tables 6-1 and 6-2 provide the necessary worksheets. 

• I/O Planning - Peripheral device I/O cards are assigned 
priorities, logical unit numbers are assigned, and tables 
are built that effect communication between the devices 
and the system. Table 6-4 provides the I/O worksheet. 

• Memory Configuration - The physical and logical 
organization of memory is discussed and planned. 
Memory protection options are presented. 

It is recommended that all the worksheets be duplicated. 
The copies can then be used for planning the system leaving 
clean copies in the manual for future use. 



DISC PLANNING 

RTE-III is a disc-based operating system where the disc 
provides the primary storage area for the following items: 

— The configured operating system 

— Relocated disc resident programs 

— Relacatable library modules 

— Temporary storage for programs (source for editing, 
relocatable output of assembler, etc.) 

— User files 

Disc storage is managed in terms of contiguous groups of 
tracks called subchannels (after generation, subchannels are 
normally referenced through logical unit numbers which are 
assigned in the I/O planning section). The primary purpose 
of the disc planning section is to configure available disc 
storage into one or more subchannels. RTE-III further 
distinguishes between these as system, auxiliary, and peri- 
pheral subchannels. The generator will interact with the 
user to define a group of subchannels on a single disc con- 
troller. Multiple controllers and mixed disc types are dis- 
cussed here under the heading, "Multiple Disc Controllers," 
and also in Appendix B. 



SYSTEM/ AUXILIARY SUBCHANNELS 

The RTE-III System disc tracks are those for which RTE-III 
controls and maintains a track usage table. Programs may 
obtain and release tracks from this area using calls to the 
executive. System tracks include all tracks on the system 
subchannel (LU2) and the auxiliary subchannel (LU3). The 
size of a system or auxiliary subchannel is limited to 256 
tracks. This number may be further reduced depending on 
the type of disc used (e.g. 203 for a 7900 disc). The system 
disc tracks are used for swapping, and by the editor, assem- 
bler, and compilers for source, load-and-go, and scratch 
area. They may also be used by user programs for storage. 
The main differences between a system and auxihary sub- 
channel are: 

• The configured system (including the memory resident 
system, the relocated disc resident programs, and the 
relocatable library), is stored on the system disc. 

• The auxiliary disc is optional. 

• Most program swapping takes place on the auxiliary 
disc. 



NOTE 

More than one system or type of system can be 
located on a disc, and those systems may share 
tracks. In designating tracks, those that are 
shared would be included and declared during 
each system generation. The restriction is that 
any tracks of an RTE-III System that are assigned 
to LU2 or LU3 (system or auxiliary subchannel) 
must be unique to that RTE-III System. 
Remaining tracks on the disc can be assigned to 
other systems. 

PERIPHERAL SUBCHANNELS 

Disc subchannels other than system and auxiliary are 
classified as "peripheral" and must be assigned logical unit 
numbers above 6. Tracks on these peripheral subchannels 
are not subject to the RTE assignment and release mech- 
anism; however, they may have the same protection. Man- 
agement of these areas may be accomplished directly by 
user supplied programs or by the File Manager. Peripheral 
subchannels to be used by the file manager must be defined 
with no more than 1 204 tracks. 
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Table 6-1 . HP 7900 Moving Head Disc Worksheet 



SUBCHANNEL 1 



REMOVABLE 




NO OF TRACKS AVAILABLE 
FIRST TRACK 



SUBCHANNEL 



NOTE: 

THE FIXED PLATTER 
DOES NOT EXIST 
ON THE 7901. 



FIXED 




NO. OF TRACKS AVAILABLE 
FIRST TRACK, 



SYSTEM SUBCHANNEL NUMBER 
AUXILIARY SUBCHANNEL NUMBER 

SCRATCH SUBCHANNEL NUMBER 
START SCRATCH (I.E. 1ST TRACK = 0) 



(LOGICAL UNIT 2) 
(LOGICAL UNITS) 
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Table 6-2. HP 7905 Disc Worksheet 



STEP 1 FILL IN UNIT NUMBER: 



STEP 2 



CYLINDER 



HEAD 



HEAD 1 



TIMING 
HEAD 



HEAD 2 



HI 



o 



CYLINDER410 




UNIT^ 



TRACKS SHOWN END-TO-END ON THREE SURFACES-CIRCLE SUBCHANNELS: 



CYLINDER 40 80 120 150 200 240 280 320 360 400 410 
HEAD »► 



HEAD 1 »► 

HEAD 2 >■ 



REMOVABLE 



STEPS 



TRANSLATE STEP 2 TO NUMBERS: 



SUBCHANNEL 














NUMBER OF 
TRACKS 














STARTING 
CYLINDER 














STARTING 
HEAD 














NUMBER OF 
SURFACES 














NUMBER OF 
SPARES 














SYSTEM ? 














AUXILIARY 














SCRATCH ? 
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HP 7900 DISC CONFIGURATION 

The HP 7900 Disc Drive is a single unit that contains two 
discs; one permanently mounted and designated subchannel 
0, and the other housed in a removable cartridge and desig- 
nated subchannel 1 . The drive is interfaced to the computer 
through a single plug-in controller occupying two I/O slots. 
It is possible to daisy-chain up to four drives to the same 
controller providing up to eight discs. Each disc platter is a 
subchannel, and is accessed through a logical unit reference 
number that is referenced back to the equipment table 
(EQT) entry number of the controller. Therefore, one con- 
troller, containing eight subchannels linked to eight logical 
unit numbers, can control up to eight discs. Refer to Table 
6-1 and fill in the blanks according to the following instruc- 
tions. 

Determine the number of tracks available and starting track 
number for each subchannel, and fill in the blanks on the 
worksheet. Note that the maximum number of tracks 
available per subchannel for the 7900 is 203. The moving 
head Basic Binary Disc Loader (BBDL) will boot a system 
on a 7900 disc only if it starts at physical track on sub- 
channel or 1 . Locating the system tracks anywhere else 
will require that a paper tape bootstrap be punched during 
generation and used each time the system is initiaHzed. 

Determine which subchannel will be the system and which 
subchannel the auxiHary (if any). Fill in the appropriate 
blanks on the worksheet. 

Refer to the heading, "Multiple Disc Controllers," for 
instructions which cover special action required if the 
auxihary subchannel is on a different controller than the 
system subchannel. 

HP 7905 DISC CONFIGURATION 



be defined on one 7905 controller. There is no fixed rela- 
fionship between a subchannel and a given disc area (as on 
7900 discs); it is the user's responsibility to define these 
relationships. 

The completed disc worksheet describes each subchannel on 
a drive in terms of the drive's unit number, size of the sub- 
channel in tracks, starting head and cyhnder numbers, sur- 
face organization, and number of tracks. In dividing up the 
HP 7905 disc tracks, bear in mind that the ulfimate goal is 
a logical unit number referencing a group of disc tracks. 

When fihing in the worksheet on Table 6-2 there are several 
important rules and guidelines to remember. 

• Surface organization. Tracks on a subchannel must be 
contiguous. Head movement should be kept to a mini- 
mum for fastest response time to sequential tracks. This 
means that track assignment should alternate between 
surfaces. For example, if track (of the first subchannel) 
is accessed by head 0, cylinder 0, and track 1 is accessed 
by head 1, cylinder 0, physical head movement (changing 
cylinders) is kept to a minimum. 

NOTE 

If a subchannel involves both fixed and removable 
platters, some flexibiUty is lost since removal of 
one platter invahdates all data on the subchannel. 
Additionally, the rotational alignment between 
two platters depends on drive orientation when 
the cartridge is inserted. This makes track-to- 
track access time across platters unpredictable. 
It may, in fact, be better or worse than on one 
platter depending on alignment and the time 
required for software processing between tracks. 



The HP 7905 Disc Drive is a single unit that contains two 
disc platters; one permanently mounted, and the other 
housed in a removable cartridge. Up to 8 drives may be 
connected to a single 7905 controller. The controller is 
interfaced to the computer through an interface card 
occupying one I/O slot. Each disc has two surfaces; how- 
ever, one surface of the fixed disc is used for timing pur- 
poses and is not available for data recording. Therefore, 
a single HP 7905 Disc Drive contains three surfaces (3 
heads) and 41 1 cylinders, giving 1,233 tracks. Refer to 
Table 6-2 for a pictoral diagram of the drive showing 
heads and cylinders. 

The purpose of the following discussion is to configure each 
disc into subchannels. Each subchannel will consist of a 
contiguous group of tracks on a single drive, and one drive 
may contain several subchannels. Up to 32 subchannels may 



If more than one surface is to be used, tracks are 
cyclically allocated downward and back to the original 
surface when necessary. For example, a subchannel be- 
ginning with head 1 and using 2 surfaces will use head 1 , 
2 and 1 repeatedly, and in that order. Note that any sub- 
channel using 3 surfaces must start on head 0. 

Spare tracks. Some tracks on a disc surface may be un- 
usable. When such a track is encountered, another track 
is assigned by RTGEN in its place, and the disc controller 
will automatically switch to that track on future refer- 
ences. During generation, spare tracks are assigned to 
each subchannel for this purpose; then when a bad track 
is encountered, a subchannel may draw from its spares. 
Note that spare tracks are allocated on a subchannel basis 
and belong to that subchannel. That is, one subchannel 
cannot take spare tracks from another subchannel. The 
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user should plan on about 1200 usable tracks per drive, 
dividing the remaining 33 tracks as spares among the 
subchannels in proportion to their size. Spares imme- 
diately follow the main tracks for the associated subchan- 
nel, and use the same surface organization. Spares are 
recommended even though they may not be used on a 
given disc. A subchannel or complete disc might later be 
copied to another disc where bad tracks are encountered, 
and all data would not "fit" without sufficient spares. 

• Subchannel size. A subchannel to be used as the system 
or auxiliary subchannel (LU2 or 3) must not exceed 256 
tracks, excluding spares. Similarly, a peripheral subchan- 
nel to be used by the file manager must not exceed 1024 
tracks, again, excluding spares. Larger subchannels may 
be defined for access by user-developed programs. 

NOTE 

If the user plans to run disc utility programs 
designed for a 7900 disc, subchannels should 
be restricted to 203 tracks or less. 

• Subchannel numbering. Subchannels on a given disc 
controller are numbered sequentially from 0. Do not 
skip or duplicate any numbers, otherwise the disc ad- 
dressing scheme is completely up to the user. 

• System Subchannel. The moving head Basic Binary 
Disc Loader will boot a system on a 7905 disc only if it 
starts at cylinder 0, head 0, 1, or 2. Locating the system 
subchannel anywhere else will require that a paper tape 
bootstrap be punched during generation and used each 
time the system is initialized. 

With the aid of Table 6-2, 7905 subchannels are defined in 
a manner directly translatable for input to the generator. 
Copies of the table have been completed for two sample 
one -drive systems and are included as suggested disc con- 
figurations in Appendix C. 

Follow the instructions below for each HP 7905 drive. 

STEP 1 — A hardware unit number is associated with 
each drive and is selected by a switch located behind the 
perforated front panel. Set the switch to the appropriate 
number and then write the number on the worksheet. 

STEP 2 — The second part of the worksheet represents 
the three surfaces of the disc drive and is provided as an aid 
in dividing up the surfaces into subchannels. Using Table 
C-1 as an example, allocate to subchannel 256 tracks for 
data and 8 tracks for spares encompassing two surfaces. 
This makes a total of 264 tracks which is 132 cylinders. 
Note that the example on Table C-1 has all the tracks for 
subchannel enclosed and labeled. The first cyHnder con- 
tains the first and second addressable track: 

— first track = head #0, cyHnder #0 

- second track = head #1 , cylinder #0 

Divide up the surfaces, grouping the tracks into subchannels. 
Allow approximately 6 spare tracks for each 200 data tracks 
allocated. The number for the first cylinder of succeeding 



subchannels is found by adding the number of cylinders 
used by preceding subchannels. (Add tracks and spares then 
divide by the number of surfaces to count cyhnders). In the 
example above, 132 cylinders were assigned to subchannel 
(256 tracks plus 8 spares). Therefore, the "First Cyl" for 
subchannel 1 would be cylinder 132, Head #0 or 1 , or cylin- 
der 0, Head #2. It depends on how you assign the tracks. 

STEP 3 - The third part of the worksheet answers all 
the questions the generator will ask about each subchannel. 
For the most part, the numbers are filled in from Step 2. 
Refer to Table C-1 for the example. 

Fill in the blanks for all subchannels created in Step 2. 

Determine which subchannel will be the system and which 
subchannel the auxiliary (if any) and check the appropriate 
boxes, 

MULTIPLE DISC CONTROLLERS 

The RTE-III generator assumes a single disc controller for 
purposes of interactively defining and initializing subchan- 
nels. If a system is to have more than one controller (same 
or different disc types), the user must construct a table, 
according to the directions in Appendix B, describing the 
subchannels of the controller before beginning generation. 
The generator will not initialize these subchannels. The user 
must include the appropriate disc driver and define equip- 
ment table entry and logical unit numbers for the subchan- 
nels (described in I/O configuration planning). 

The optional auxiUary subchannel may be placed on a dif- 
ferent controller than the' system subchannel. The preceding 
discussion applies in this case with the added requirement 
that the user specify the number of tracks in the subchannel 
when the generator inquires about the auxiliary option (see 
part 2 of this section), 

MULTIPLE CPU/7905 SYSTEMS 

The HP 7905 versions of RTGEN, the bootstrap loader, and 
the on-line driver support multiple CPU operation. More 
than one CPU can share one or more disc drives under the 
following conditions: 

• The system area (that is, LU2 and LU3) for one CPU 
cannot occupy the same system disc tracks as that of 
another CPU. 

• Systems may map tracks in the same peripheral disc 
area. However, they should share access to these areas 
only as described in Appendix B under Multiple CPU/ 
7905 System Operation. 

• The generator should not be allowed to use as scratch or 
to initiahze areas of the disc already in use by any other 
CPU. 

As an aid to using a multiple CPU system, it is recom- 
mended that the disc track map be identical for each CPU. 
Further, logical unit numbers should not be assigned to sub- 
channels already assigned to another CPU. 
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GENERATOR SCRATCH AREA 

RTGEN requires a scratch area for storing relocatable mod- 
ules used to build the system. This area is defined only for 
the duration of the generation and may be placed on any of 
the subchannels. Two factors must be considered in selecting 
the size of the area. (1) The area must be large enough to 
accomodate all the relocatable modules, otherwise, an 
ERR 1 7 will occur, and (2) the area cannot be so large that 
the system area will prematurely overflow into it (ERR38) 
during the disc loading phase. The ERR38 can occur when 
the scratch area is located on the system subchannel and the 
absolute system is built upwards, toward, and into the relo- 
catable modules, overlaying the latter before they have been 
converted into absolute code. Due to this possibiUty, it is 
recommended that the scratch area not be located on the 
system subchannel. 

Determine which subchannel will provide the scratch area 
and indicate on the appropriate disc worksheet. If the 
scratch area is located on the system subchannel, it is recom- 
mended that the entry for "start scratch" be zero (0). 

This entry causes RTGEN to start the scratch area at the 
midpoint of the available disc area. (Note that this default 
occurs only when scratch is located on the system subchan- 
nel.) If either of the two error codes (ERR17 or ERR38) 
are experienced during RTGEN, use the data in Table 6-3 as 
a guide in adjusting the scratch area. A rule-of-thumb formula 
for determining the approximate number of 64 word sectors 
a user written program will occupy is as follows: 



Table 6-3. Approximate Number of 64-Word Sectors 
Required to Store RTE-III in Relocatable 
Format 



# of 64 word sectors = — 



where 



NAME 


64-WORD SECTORS 


Executive Software 

System Library 

ASMB 

XREF 

FORTRAN 


210 
50 

210 
60 

350 


RTE/DOS FORTRAN IV 

Compiler 

RTE/DOS FORTRAN IV 

1 OK Compiler 

ALGOL 


470 
360 
180 


Interactive Editor 

Loader 

RTE/DOS Relocatable 
Library 


70 
150 
240 


RTE/DOS FORTRAN IV 

Library 

RTE/DOS HP FORTRAN 

Formatter 

RTE/DOS Plotter 
Library 


290 
45 
80 


Drivers 


Allow 1 5 sectors per 
driver. 



X = number of words of memory the program 
occupies. 

NOTE 

Table 6-3 and the formula are only approximate 
guides to be used as an aid if using the RTGEN 
scratch default does not work or if difficulty is 
experienced in estimating some other starting 
point for scratch. 



If the scratch area is assigned to a subchannel other than the 
system subchannel, that subchannel should not have tracks 
shared with another system, or any data on it that must be 
retained. This is because the scratch subchannel tracks as- 
signed to the system being generated are initialized by 
RTGEN. As a result, any data on them is destroyed. 



The first logical track number of the scratch disc is always 
zero (0) regardless of the actual track address. For example, 
if the scratch is located on a subchannel consisting of cyl- 
inders 100 to 200, the starting logical track for the scratch 
disc would be track zero (0). To start the scratch area on a 
track inside the available area, count the number of tracks 
into the area and use that number as the starting track (e.g., 
to skip the first 10 tracks, start scratch on track number 10). 



INPUT/OUTPUT PLANNING 

Input/output locations in all HP 2100 series computers have 
the same sequence of priority addresses: the highest priority 
address is the lowest numbered select code (I/O location). 
The octal select codes start at octal 10 and continue upward 
toward octal 77, limited by the I/O capacity of the particular 
computer and any attached extenders. 
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Interface cards are assigned to priority addresses according 
to the speed of interrupt response required by tlie I/O device. 
Interface cards for high-speed devices are assigned higher 
priority addresses than low-speed devices. Devices requiring 
privileged interrupt are always assigned to the highest 
priority addresses, while direct memory access devices are 
assigned the lowest. The one exception to the direct memory 
access rule is in regard to the moving head system disc con- 
troller. For the fastest interrupt response, assign moving head 
disc controller to the next available I/O slots after the Time 
Base Generator (TBG). 

The following instructions are keyed by step numbers to the 
I/O Configuration Worksheet in Table 6-4. Fill in the blanks 
as you plan your system. 

STEPl: I/O LOCATIONS 

Considering the factors given in the preceding paragraphs 
and the instructions given below, select the priority addresses 
for each I/O card, and fill in the top portion of the Input/ 
Output Configuration Worksheet table with the I/O card 
name, and the appropriate select code (I/O slot). 

NOTE 

The top portion of the table is used for either 
the select code or the subchannel number. For 
example, if two HP 7900 moving head disc 
drives (four subchannels) are connected to a 
controller in select codes 20 and 21 , the top 
portion of the table would be completed as 
follows: 



octal selecjx"^^ 


20/ 


21/ 


/ 


/ 


1 


1 


codit^y^ 






/ 


/ 


/ 


1 


^^ subchannel 






/o 


j\ 


ll 


h 



This method of noting subchannel numbers will 
facilitate assigning logical unit numbers later in 
the table. Refer to the HP 7905 Disc worksheet 
for applicable subchannel numbers. 

The following detailed steps show how to assign select codes 
to devices starting at the highest priority address, octal select 
code 10. In addition to these steps, make certain that any 
peripheral devices or subsystems that use multiple I/O slots 
have their I/O cards together and in the relative order 
required by that device or subsystem. 

a. Assign all devices that require privileged interrupt in order 
of decreasing response time requirements (i.e., time from 
interrupt to service). 



b. After the privileged devices, assign the privileged interrupt 
I/O card. 

c. Assign the TBG I/O card. 

d. Assign the moving head disc controller I/O cards. 

e. Assign all devices that do not use direct memory access in 
order of decreasing speed. 

NOTE 

There will be occasions when a device uses direct 
memory access for data transfer and still generates 
an interrupt for end-of-record (EOR) processing. 
In these cases the hardware priority of the device 
should be treated as a non-DMA device, with the 
interrupt rate of the EOR condition determining 
its priority location. Some consideration should 
be given to the priority of a data transfer vs. the 
priority of a record termination. Data transfers 
would normally be given priority over EOR 
interrupts of equivalent or even sHghtly slower 
interrupt rates. 



f. Assign all devices that do use direct memory access in 
order of decreasing speed. 

g. If an I/O extender is required and the extender does not 
have direct memory access capabiUty, the order of steps 
"e" and "f ' can be reversed so that all direct memory 
access devices are in the computer mainframe. If this 
step is necessary, maintain the same relative order of 
speed assignment among the DMA and non-DMA devices. 

STEP 2: STANDARD LOGICAL UNIT ASSIGNMENTS 

Make the standard logical unit number (LU) assignments 
(1 through 6) to I/O devices by placing an X at the inter- 
section of the standard logical unit number and the I/O card 
select code. Place an X under one of the disc subchannels 
for LU2; include LU3 if appUcable. Any remaining disc sub- 
channels can be assigned logical unit numbers above six 
(i.e., they become peripheral if desired). 

STEP 3: ADDITIONAL LOGICAL UNIT ASSIGNMENTS 

Starting with decimal 7, write in the logical unit numbers 
sequentially for each device or subchannel number as 
appHcable. These numbers can be arbitrarily assigned to I/O 
devices, and do not have to be written in a left to right order 
on this table. However, if a magnetic tape unit is being 
configured into the system it is recommended that it be 
made LU8. The power fail routine should be the last (or 
highest numbered) LU. 
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NOTE 



STEPS: TIME-OUT 



If a device has two I/O cards use only the highest 
priority (lowest select code) I/O card for steps 
2 and 3. 



Write in a large "T" for devices that will use the time-out 
parameter. Values will be assigned later on the configuration 
worksheet. 



STEP 4: DRIVER IDENTIFICATION 

Write in the driver identification number for each device; 
e.g., teleprinter driver is DVROO. If the 7900 disc drive is 
used, in addition to placing DVR31 under the high-priority 
card, place a large "I" under the low priority card. For other 
devices or subsystems that have more than one I/O card, refer 
to the I/O card or subsystem documentation covering that 
device and driver. Place an "I" under the select code number 
of all I/O cards (i.e., every I/O card must have an entry in the 
interrupt tables). Place a dash under subchannel numbers. In 
the case there is more than one driver with the same DVR 
number, refer to the paragraph under Equipment Table 
Entries later in this planning part. 

STEP 5 : DIRECT MEMORY ACCESS 

Write in a large "D" for direct memory access required on 
each device that will use this capability. Note that some 
drivers, such as DVR62 for the HP 2313 sub-system, are 
capable of dynamically assigning a DCPC channel to them- 
selves when required. In those cases, do not assign direct 
memory access. Refer to individual driver documentation 
for more information on this capability. 

STEP 6: EQT TABLE 

Starting with decimal 1 , write in the Equipment Table Entry 
(EQT) numbers sequentially for each device. The system 
disc should be EQT number 1 to permit special priority 
assignment to an available DCPC channel. Other DMA devices 
should then be assigned EQT numbers in order of their DMA 
priority. A device that has subchannels is assigned the same 
EQT number for each subchannel. It is recommended that 
whenever possible, the EQT number be the same as the LU 
number. This will aid the user in operating the system after 
it is running. It is also recommened to make the power fail 
routine the last (Highest numbered) EQT. 



STEP 7: BUFFERING 

Write in a large "B" for devices that will use output buffer- 
ing. Bufferjmg means that the computer will copy into a 
system buffer data that is to be output to a device (e.g., 
hne printer). The system will allow a program to continue 
processing after issuing a WRITE request to such a device, 
rather than suspending the program while it waits for a 
buffer (in the program) to be emptied. 



STEP 9: EXTENDED EQT 

Write in a large "X" for drivers that will use the extended 
EQT feature. For example, each entry for Spool Monitor 
Driver DVS43 will use the EQT extension. Values will be 
assigned later on the configuration worksheet. 



MEMORY CONFIGURATION PLANNING 

RTE-III, as described in Section I, provides the capabiHty 
of addressing physical memory configurations of up to 1 024K 
words. This portion of the planning part describes most of 
the considerations you must make when dividing up physical 
memory, setting up partitions, establishing memory 
protection, and actually loading programs. This material is 
provided for both reference and planning purposes to help 
the user. Some actual inputs to the generator will depend on 
the user analyzing the data printed out by the generator to 
that point, and making his decision based on that hard data 
with the aid of the considerations presented here. 

PHYSICAL MEMORY 

Physical memory is organized as shown in Figure 6-1. The 
organization is fixed although relative sizes of the areas will 
depend on installation needs. Some areas (e.g., common) 
will not exist in all systems. The user determines the size of 
system available memory, size of each partition, the size of 
common, and the size and composition of the resident 
library and memory resident program area. 

MEMORY SIZE — The size of physical memory depends on 
the hardware supplied. RTGEN can configure a system from 
32 to 1024 pages long. 

SYSTEM BASE PAGE - The system base page contains the 
system communication area and is used by the system to 
define request parameters, I/O tables, scheduling Hsts, 
operating parameters, memory bounds, etc. System and 
library Hnks, memory resident program links, and trap cells 
are also located on the system base page. The base page links 
for memory resident programs are not accessible by disc 
resident programs and therefore may not be shared. System 
and library links and the system communication area are 
available to all programs for read-only access. 
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The system communication area is fixed. The size of the 
system Unks area varies with the number of page crossings 
which cause indirect Unks to be generated on base page 
(current page Unking can reduce the number of base page 
links used; see Part 3). 

After the assignment of I/O interrupt locations (see Input/ 
Output Planning), the user has no direct control over the 
aUocation of the base page area. Linkages are aUocated as 
needed during the generation. If the base page linkage area 
overflows an error message is given and the user must delete 
one or more programs from the memory resident area of the 
system. As an aid in generation, RTGEN wiU optionally trace 
the aUocation of links, program by program. 

SYSTEM AND LIBRARY AREAS ^ These two areas 
become a part of every program's logical address space (see 
Figure 6-2). Since each program is Umited to 32K address- 
ability, the size of this area directly reduces the area available 
for user programs, system avaUable memory, and memory 
resident program area. 

The system area contains type system modules (e.g., 
RTIOC, SCHED, EXEC) and drivers plus tables. The size of 
the system area is indirectly controUed by the number of 
I/O devices configured (i.e., table sizes and drivers). 



The memory resident library area contains those re-entrant 
or priviledged library routines which are used by the memory 
resident programs (type 6) or which are force loaded (type 
14) at generation time. Placing a module in this area means 
it doesn't need to be appended to programs that call it, but 
it is subject to special design constraints so that two programs 
wiU not inadvertantly gain concurrent access. Refer to the 
section of the Relocatable Library when designing such sub- 
routines. 

COMMON AREA — This area is divided into three subareas: 
The Subystem Global Area (SSGA), the Real-Time Common 
Area, and the Background Common Area. Common's size is 
important to all memory resident programs (they can only 
use that part of 32K remaining after common), and to disc 
resident programs using one of the three subareas. Disc 
resident programs using one of the common subareas must 
"map" the whole common area, thus reducing the amount 
of logical address space left over for the program. 

The Subsystem Global Area is used by HP subsystems and 
contains type 30 modules loaded sequentially. The modules 
are accessed by their entry point and not through common 
declarations. 



The Real-Time Common Area defaults to the maximum size 
common declared by any main program "typed" to use it. 



Real-time programs use Real-Time Common as the default 
case. Background programs may use Real-Time Common 
if "reversed" common is specified. 

The Background Common Area defaults to the maximum 
size common declared by any main program "typed" to 
use it. Real-time programs use Real-Time Common as the 
default case. Background programs may use Real-Time 
Common if "reversed" common is specified. 

If a program (memory or disc resident) is to use common, 
the maximum size to be used must be declared in the main 
module. Subroutines and segments used by the program 
will access the same common as the main. 

If desired, the size of the Real-Time and Background 
Commons may be increased during generation to accomo- 
date future programs loaded on-line. Do not confuse these 
system-wide common areas with the local common area 
which may be specified for a program loaded on-line. The 
local common area is appended to the program (i.e., it wiU 
be in the program's partition), and is accessable only to 
that program, its subroutines, and its segments. 

The common area may optionaUy be included in the System 
Map to aid privileged drivers. This makes common 
immediately accessable at interrupt. Refer to the part in 
Section V on privUeged drivers. 

MEMORY RESIDENT PROGRAM AREA - This area 
contains aU type 1 programs and is loaded sequentially 
foUowing common. It is recommended that the first word 
of this area be aligned on the first page boundary following 
common. The area skipped is then appended to Background 
Common. This alignment is desirable to protect the Memory 
Resident Program area. Refer to the heading, Memory 
Protection for more information. AU memory resident 
programs must faU within the first 32K of physical memory. 
The last word of the last Resident Program must fall at or 
before 77677 (octal), leaving 64 words for operation of the 
loader. If this address is violated, ERR 18 is printed, 

SYSTEM AVAILABLE MEMORY (SAM) ~ This is a 
temporary storage area used by the system for Class I/O, 
re-entrant I/O (refer to Section III), and automatic buffering 
The amount of SAM depends on specific appUcations. The 
lack of enougli buffer space can cause temporary suspension 
or obortion of a program. Subsystem (communications, 
spooling, etc.) may place additional requirements on this 
area; refer to the appropriate manuals. 

SAM may start immediately after the memory resident 
programs or be aligned at the next page. Alignment prevents 
accidental destruction of critical data by another program 
accessing the same page. Any words skipped due to align- 
ment are wasted. 
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DESCRIBED BY 
SYSTEM MAP 



THREE POSSIBLE CONFIGURATIONS DESCRIBED BY USER MAP 



SYSTEM 



MEMORY 

RESIDENT 

PROGRAM 



DISK RESIDENT 
PROGRAM & 
COMMON 



DISK RESIDENT 
PROGRAM, W/0 
COMMON 



SYSTEM 

AVAILABLE 

MEMORY 



(COMMON 
OPTIONAL IN 
SYSTEM MAP) 



MEMORY 
RESIDENT 



MEMORY RESI- 
DENT PROG 2 



MEMORY RESI- 
DENT PROG 1 



BG COMMON 



RT COMMON 



SUBSYSTEM GLOBAL 



UNUSED AREA 

READ/WRITE 

PROTECTED 



DISK 

RESIDENT 

PROGRAM 



BG COMMON 



RT COMMON 



SUBSYSTEM GLOBAL 






DISK 

RESIDENT 

PROGRAM 



RESIDENT LIBRARY 



RESIDENT LIBRARY 



RESIDENT LIBRARY 



RESIDENT LIBRARY 



SYSTEM 



SYSTEM 



SYSTEM 



SYSTEM 



COMMUNICATION 
AREA, SYSTEM 
LINKS, & RESIDENT 
PROGRAM LINKS 



COMMUNICATION 
AREA, SYSTEM LINKS 
& RESIDENT PROG 
LINKS 



COMMUNICATION 
AREA, SYSTEM LINKS, 
& PROGRAM LINKS 



COMMUNICATION 
AREA, SYSTEM LINKS, 
& PROGRAM LINKS 



(2) 



(3) 



-^ INDICATES POSSIBLE 
MEMORY PROTECT 
FENCE SETTINGS 

POSSIBLE PAGE ALIGNMENTS 



Figure 6-2. RTE-III 32K Logical Memory Configurations 
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SAM always ends at a page boundary where the first disc 
program partition starts. Therefore, its size defaults to the 
number of words between its starting address and the next 
page (between 1 and 1024 words). The recommended 
minimum is IK words. The size limit is: 

System + Library + SAM + (optionally) 
Common < 32 pages 

System Available Memory size can be increased in IK word 
increments by increasing the page number where the disc 
partitions start. 

DISC PARTITIONS - The number of pages remaining 
after SAM must be divided up into distinct partitions 
(maximum of 64). Each partition should be at least two 
pages long, one page to be used as a base page and the 
remainder for the program. This includes subroutines, over- 
layable segments, and buffer/table space. 

The size of a given partition depends on program needs. 
A Disc Resident program, out of its 32K of address space, 
usually has 13 to 16 pages taken up by the system and 
library area. Some programs use a common area which must 
be mapped. This may result in less address space for the 
programs depending on the size and location of the common 
area. Therefore, a useful partition will normally be between 
2 and 20 pages long. 

The generator reports the largest useful partition sizes for 
programs with and without common (including a base page 
for the program) to aid the user in determining partition 
sizes. 

Partition size requirements for each program relocated are 
also reported; however, some programs may require 
additional pages for buffer area as discussed under the head- 
ing "Disc Program Size Considerations." It may not be 
possible to completely plan partition sizes until this infor- 
mation is reported by generator. 

A program cannot be dispatched for execution unless a 
partition of sufficient size is defined and available (not 
reserved for the exclusive use of other programs). 

The user must determine the mix of Real-Time and Back- 
ground partitions of appropriate sizes to suit his particular 
application and subject to available main memory. Two 
classes of partitions prevents competition for main memory 
between background programs (typically involved in 
program development of other non-time-critical apphcations) 
and Real-time programs. Note that the class of a partition 
does not imply any special attributes, but merely that 
programs of the same type may use that partition subject 
to exceptions noted below. 



In some situations, placing all partitions in a single class may 
be best. This allows free competition for main memory 
between all disc programs, subject to program priority and 
size requirements. 

Undesired competition for partitions can be prevented by 
assigning programs to specific partitions. This could, for 
example, keep a very small program out of a large partition. 
Assignment can cross class boundaries; a Real-time program 
can run in a Background partition, and vice-versa. (Such a 
program would still have all the attributes of a real time 
program). 

DISC PROGRAM SIZE CONSIDERATIONS 

Section I of this manual discusses program size. The 
generator reports the partition size required for each disc 
program loaded. This size includes a base page and is 
based on the length of the main program, subroutines 
loaded with the main, and the largest overlay able segment 
(if any). 

Program size can be overriden during the generation, thus 
increasing the minimum size partition required. When the 
program is run, it may be given a partition larger than this 
minimum. To the program however, the "apparent" size 
of the partition (determined from the System Communi- 
cation Area during execution) is still the minimum. 



Some programs require additional space to dynamically 
construct buffer areas or symbol tables. Standard RTE 
programs needing this additional space are shown with 
their requirements in Table 6-5. During generation the 
user must modify the page requirements of any of these 
programs to be used. Size requirements for user-supplied 
programs may be overriden if necessary. 



MEMORY PROTECTION 

Memory protection between disc resident program partitions 
and between disc and memory resident programs is provided 
by the Dynamic Mapping System. A program cannot access 
a page not included in its logical memory either directly or 
through a DCPC transfer. Since many programs will not use 
all of the possible 32K logical area, unused logical pages 
above the program are READ/WRITE protected and do not 
necessarily have counterparts in physical memory. 

A different form of protection is required for the system, 
library, and (optionally), common. The memory protect 
fence provides this protection by preventing stores and 
jumps to locations below a specified address. All possible 
fence positions are shown in Figure 6-2. 
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Table 6-5. Programs Requiring Buffer Space in Partitions 



PROGRAM 

NAME 



EDITR 



MINIMUM 

RECOMMENDED 

OVERRIDE 

(pages) 



ASMB 



XREF 



LOADR 



ALGOL 



FTN 



FTN4 (small) 



FTN4 (large) 



FMGR 



RT2GN 



RT3GN 



7 (Note 1 



6 (Note 1 



8 (Note 1 



9 (Note 1 



6 (Note 1 



7 (Note 1 



1 1 (Note 1 



12 



12 



SUGGESTED 
OVERRIDE 

(pages) 



7 (Note 2) 



10 (Note 3) 



10 (Note 3) 



10 (Note 3) 



13 (Note 3) 



8 (Note 3) 



9 (Note 3) 



13 (Note 3) 



7 (Note 4) 



12 (Note 5) 



12 (Note 5) 



Note 1 : Running this program with this size partition 
will limit the size of the programs it can 
process. In some cases, however, experience 
may show that even small partitions will 
suffice. 

Note 2: Limited to "Largest Addressable Partition" 
size printed during generation. Extra space 
increases size of two disc buffers thereby 
improving performance. 

Note 3: Limited to "Largest Addressable Partition" 
size printed during generation. Extra space 
increases symbol table space thereby allow- 
ing larger programs to be processed. 

Note 4: Extra space is used during a disc packing 
operation. 

Note 5: Extra space for the generator virtual symbol 
tables increases the generator's speed. 



For programs using common, all of logical memory in- 
cluding common is mapped and the fence is set at one of 
three possible locations, depending on the portion of 
common being used. A hierarchy of protection is thereby 
established within common due to their physical locations. 
Background common is the least protected (any program 
using any common can modify it) and SSGA is the most 
protected (only programs authorized for SSGA access can 
modify it). Figure 6-3 expands the common area and shows 
these three fence settings as (a) , (b) , and (c) . 

Figure 6-3 also shows a potential problem area marked "?" 
which includes those words from the top of common to the 
next page boundary. This area could include one or more 
memory resident programs and/or part of System Available 
Memory. Any program using common could potentially 
destroy the contents of this area. Aligning the top of common 
at the next page boundary is a generation option that expands 
the size of background common while eliminating this 
problem. A similar option is available for the boundary 
between memory resident programs and system available 
memory. 



BG COMMON 



RT COMMON 



SSGA 



© 



® 



Figure 6-3. Memory Protect Fence Locations for Programs 
using Common. 



PAGE BOUNDARY 



HIGHER PHYSICAL 
MEMORY 



The memory protect fence applies to the logical address 
space and addresses are compared to the fence before 
translation. If a disc resident program does not use any of 
the common areas, the memory protect fence is set at the 
bottom of the program area. Similarly, for a memory 
resident program not using common, the memory protect 
fence is set at the base of the entire memory resident area. 



PROGRAM LOADING 

Program loading refers to RTGEN taking the relocatable 
modules from the scratch area, relocating them to absolute 
addresses in physical or logical memory, and storing them 
permanently on the system subchannel. 
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SYSTEM MODULES - These are type modules (EXEC, 
RTIOC, SCHED etc.) and are loaded sequentially above the 
system base page. Base page links for these modules are 
allocated downward in the system base page below the 
system common area. 

LIBRARY MODULES - These are type 6 and 14 (re-entrant, 
privileged, and force-loaded) and are loaded sequentially 
above the system and tables. Base page hnks for these 
modules are allocated downward in the system base page 
below the system links. 

MEMORY RESIDENT PROGRAMS - These programs are 
sequentally loaded above the common areas. Base page links 
for these programs are allocated upward in the system base 
page starting at FWA BP LINKAGE (established by the user) 
above the I/O interrupt locations. 

DISC RESIDENT PROGRAMS WITHOUT COMMON - 

These programs are relocated into logical memory and stored 
on the disc. Each program starts at word 2 of the next avail- 
able logical page after the end of the system and memory 
resident library. The first two words of the page are reserved 
to save index registers in the event the program is interrupted. 



Base page links are allocated upward from logical location 2. 
The highest available Hnk address is the word befoie the 
lowest system/library link. These links are written on the 
disc and are referred to as the user base page. This user base 
page is swapped with the program into memory and placed 
into the first page of the selected partition. 

DISC RESIDENT PROGRAMS WITH COMMON - These 
programs are treated the same as the disc resident programs 
without common. The only difference is that the program 
starts at word 2 of the logical page following the common 
area. 



PRIVILEGED DRIVERS 

Privileged drivers must be considered when doing the 
generation. Practically, the privileged drivers will have al- 
ready been written according to the directions given in 
Section V. If the driver was written to use the common area 
then the generator question about privileged drivers access- 
ing common will have to be answered YES, causing common 
to be included in the System Map. Otherwise, it is assumed 
that driver is performing its own mapping functions. 
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PART 2 

Preparing Generator Responses 



The plans in Part 1 and the procedures described in Part 2 
aid the user in preparing responses to RTGEN questions. 
These responses are written on Table 6-6, a worksheet 
located at the end of this part. The user can then use the 
worksheet to enter the correct responses to the computer 
as the generation proceeds. As the user becomes more 
familiar with the system and generation procedure, a 
punched tape containing all the parameter inputs can be 
made up from the worksheets and then placed in the tape 
reader (either the teletype tape reader or high-speed 
photoreader). The generator will read such a tape auto- 
matically and operate at a much higher speed than if the 
responses were entered interactively through the system 
console. 

The worksheet has been keyed to the text by step numbers 
for easy cross-reference between the two. 

This part is organized in parallel with the "phases" exe- 
cuted by RTGEN during operation. Some phases do not 
require user responses, but have been listed for complete- 
ness. The phases include: 



Initialization - Disc areas are described and initiaUzed. 
Various system parameters are entered. 

Program Input - All relocatable tapes are loaded into 
the system by the user. 

Parameter Input - The default characteristics of 
programs just loaded can be overriden. Entry point 
values can be modified. More system parameters are 
entered. 

System loading — system executive routines, drivers 
and user written system routines are relocated by the 
system to absolute memory locations. 

Table Generation - tables describing the I/O 
configuration are constructed. 

Program loading - Memory resident library routines 
and memory resident programs are relocated by the 



system. Common areas are constructed and disc 
resident programs are relocated by the system. 

Partition definition — Partitions for disc resident 
programs are defined. Program size requirements can 
be modified, and programs may be assigned to run 
in specific partitions. 



INITIALIZATION PHASE 

The first portion of Table 6-6 is divided into two parts- 
one for HP 7900/7901 initiaHzation and one for HP 7905 
initialization. Refer to the appropriate heading and fill in 
the blanks for the type disc drive you have. 

During the initialization phase, RTGEN first requests 
information necessary to generate track map that defines 
disc subchannels. Once the track map is estabhshed, 
RTGEN goes on to request more information necessary 
to generate the system. 

HP 7900/7901 DISC INITIALIZATION 

The answers to the following steps can be obtained from 
Table 6-1 , the HP 7900/7901 System Disc Worksheet. 

STEP 1 - Write in the lower numbered/highest 
priority select code (I/O slot) for the disc controller. 

STEP 2 — Fill in the track assignments for each 
subchannel, A zero (0) entered for number of tracks 
causes RTGEN to ignore that subchannel. 

Go to STEP 3. 

HP 7905 DISC INITIALIZATION 

Many of the answers to the following steps can be obtained 
from Table 6-2, the HP 7905 System Disc Worksheet. 

STEP 1 -Write in the lower numbered/highest priority 
select code (I/O slot) for the disc controller. 
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STEP 2 

Table 6-2. 



Fill in the blanks for each subchannel from 



STEPS — The number of 128-word sectors per track 
is 48. This is the number of logical sectors per track and is 
the number of sectors on two sides of the platter on a 
7900 disc, one side on a 7905. 



fer time is 25 milliseconds for each 3K words. For the 
HP 7905 Disc Drive, the transfer time is 16.7 milliseconds 
for each 6K words. To obtain an accurate figure tailored 
to memory size, program size, and disc type, refer to 
Figure 6-4, Swap Delay Graph. (Note that the graph takes 
track switching time into account.) Remember, the number 
selected here is appHed to all swappable programs. 



STEP 4 - Fill in the blanks for the system and scratch 
subchannels from the table. If only one subchannel was 
defined in step 2, place a dash (i.e., does not apply) in 
system subchannel, auxiliary disc, auxiliary disc subchannel, 
and scratch subchannel blanks. 



STEP 5 

follows: 



The auxiliary disc question is filled in as 



• Enter NO if none. 

• Enter YES if it is to be one of the subchannels specified 
in step 2. 

• Enter number of tracks on the subchannel if it is to be on 
a different controller. 

If YES is entered, fill in the subchannel number in the next 
blank. Note that the auxiliary subchannel may have no 
more than 256 tracks assigned to it. 

STEP 6 - Fill in the select code of the Time Base 
Generator (TBG) card. 

STEP 7 - Fill in the select code of the privileged 
interrupt card. The next question is answered as follows: 
YES if the common area is to be included in the System 
Map for access by privileged drivers. NO if not. 

STEP 8 — The core lock questions are answered with 
a YES or NO. If YES is answered to either of these 
questions, it allows a program of the corresponding type 
to lock itself into memory and not be swapped. If the 
answer is NO then the program cannot be locked into 
memory. Refer to the PROGRAM SWAPPING CONTROL 
call in Section III. 

STEP 9 — The answer to the Swap Delay question is 
a decimal number between and 255 that represents tens- 
of-milhseconds (i.e., to 2550 milliseconds). If a number 
"N" is entered here a program will not be swapped if it 
resides in a disc resident area, is in the time hst, and is to 
run within "N" milliseconds of the current time and has 
priority over its contender for that core area. The amount 
of time required for a program to swap depends on several 
factors; type of disc drive, program length, and if the pro- 
gram is segmented. For the HP 7900 Disc Drive, the trans- 



STEP 1 - MEM SIZE refers to the decimal number of 
pages in the system. Fill in the blank. 

STEP 1 1 — The use of input units is interchangeable. 
Maximum versatility can be achieved by designating one 
device for paper tape and one for magnetic tape if magnetic 
is present on the system. For example, if most of your 
relocatable programs are on magnetic tape and only a few 
on paper tape, it would be most efficient to set up the 
magnetic tape as the program input device (PRGM) and the 
paper tape reader as the library (LIBR) input device. Note 
that there is no difference between programs input through 
the PRGM device and those input through the LIBR device; 
any program may be loaded through either device. Part 3 
of this section describes the mechanism for switching 
between devices during input. 

The program input and library input devices can be ; 

PT — paper tape (photoreader) 
TY — teleprinter 
MT — magnetic tape 
The parameter input device is either PT or TY. 

STEP 12 — The user has the option of initializing or 
not initializing the tracks on each subchannel. RTGEN 
automatically initializes tracks on the system, auxiliary, 
and scratch subchannels. If other subchannels are avail- 
able RTGEN asks if they are to be initialized by sub- 
channel number in ascending order. Write in YES or NO 
for each subchannel. If the answer is YES, RTGEN 
initializes the tracks on that subchannel and reports any 
defective tracks. (On a 7900 disc subchannel, only those 
tracks assigned to RTF in step 2 are initialized.) If the 
answer is NO, RTGEN does not initialize that subchannel. 

NOTE 

Any subchannels containing tracks shared with 
other systems should not be initiahzed because 
that data will be destroyed. 

BAD TRACK INFORMATION 

7900 DISCS - Up to 10 bad tracks are allowed before 
RTGEN aborts. Bad tracks in the area where the absolute 
system and relocatable library are stored will prevent 
operation of the system (this is the area reported at the 
end of generation). 
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PROGRAM SIZE IN K-WORDS ^p|^^^_^3 



THIS GRAPH REPRESENTS THE TIME IT TAKES TO READ OR WRITE A PROGRAM 
TO THE DISC. THE TIMES SHOULD BE DOUBLED TO GET TOTAL SWAP TIME. 



NOTES: 



EXAMPLE; 



RANDOM ACCESS TIME WHICH 
TWO QUANTITIES. 



IS COMPOSED OF 



A. THE ROTATIONAL DELAY. THIS DELAY 
RANGES FROM TO ONE ROTATION TIME (RT) 
WITH EQUAL PROBABILITY, THUS THE 
AVERAGE ROTATIONAL DELAY IS RT/2. 

B. THE SEEK TIME (ST). FOR A FIXED HEAD 
DISC ST = 0. FOR A MOVING HEAD DISC IT 
RANGES FROM TO SOME MAXIMUM WITH A 
NON-EQUAL PROBABILITY. THE SEEK TIME 
DEPENDS ON THE LAST ACCESSED TRACK 
NUMBER. 

. HP 7900/7901 
. HP 2771 
. HP 7905 



USING THE ABOVE PRINCIPLES AND GIVEN THE 
FOLLOWING DATA FOR AN HP 7900 DISC, WE CAN PLOT 
THE LOAD/SWAP TIME AS A FUNCTION OF THE NUMBER OF 
WORDS. NOTE THAT THE NUMBER OF WORDS IS AFFECTED 
BY THE "ALL OF CORE BIT." 



FOR AN HP 7900: 



RT = 25 MS 
#RT'S/TRACK = 2 
#WORD/RT =3K 



Figure 6-4. Swap Delay Graph 
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Defective tracks are reported as shown below: 

BAD TRACK SUBCHNLx 

OOOyyy 

where yyy is the logical track number and is needed when 
initializing the file manager for the subchannel (x) reported. 

7905 DISCS - Bad tracks are automatically spared by the 
disc controller to tracks set aside for that purpose in the 
initialization phase. If there are not enough spare tracks 
available, RTGEN issues the error message ERR43 and then 
restarts the initialization phase. Bad tracks reported and 
spared during generation will not prevent operation of the 
system and should not be specified during file manager ini- 
tiahzation of a cartridge on the subchannel. 



Real-Time Disc Resident Programs 
Assembler (Main and its Segments) 
FORTRAN (Main and its Segments) and/or 
FORTRAN IV (Main and its Segments) but not both 

FORTRAN IV Versions 
ALGOL 
Auto Restart 
Relocating Loader 
Editor 

Batch Monitor 
Other Background Disc-Resident Programs and their 

respective segments, if any. 
System Library 
Batch Monitor Library 
Library Programs 
Utility Programs 



Defective tracks are reported as shown below: 

LOGICAL CYL HD UNIT 

BAD TRACK xxxx xxxx x x 

SPARED TO xxxx xxxx x x 



STEP 13 - The punch boot question is optional. If the 
computer is equipped with a built-in disc loader, the boot- 
strap tape may not be needed to initialize the system. This 
depends on where the first track of the system is located. 
Refer to Part 1 . Otherwise this blank requires a minimum 
of one YES answer. Write in YES for as many bootstrap 
tapes as you desire. Write in NO for termination. 



PROGRAM INPUT PHASE 

At this point in the generation, all the relocatable modules 
are loaded into the system. 

Due to the large number of tapes to be loaded, it is recom- 
mended that they be placed on a table in the following 
order. That way they are handy when the time comes to 
start loading. 

Memory Resident System 

I/O Drivers 

Power Fail (DVP43) 

System Programs written by the user 

Multi-Terminal Monitor 

Memory Resident Programs 



NOTE 

Some of the above relocatable modules may not 
be present in some configurations. 



PARAMETER INPUT PHASE 

During the parameter input phase, the operator can modify 
the type, priority, or execution intervals and the ENT 
(entry) records of any of the programs entered during the 
program input phase (except that the primary type code of 
background mains and their segments cannot be changed 
without losing their relationship to each other) 



RTGEN has an additional feature that applies to memory 
and disc resident programs. During the Parameter Input 
Phase one program can be scheduled to execute automati- 
cally whenever the RTE-III System is loaded from the 
system disc. This is accomplished by adding 80 to the 
program's type code. For example, if PROG is originally 
a type 2 program (real-time disc-resident), it can be 
changed to: 

PROG,82 [,priority] [,execution interval] 

This will cause PROG to be scheduled automatically each 
time the system is loaded into core from the disc and after 
the file manager has been scheduled for initiaUzation. If 
more than one program is assigned for automatic scheduHng, 
only the last one entered will be recognized. 



STEP 14 — Write in the parameter records on the 
worksheet using the following general form: 

name,type[ , priority] [, execution interval] 
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Where: 

name is the name of the program. 

type is the program type code (the following are 
primary types): 

— system program or driver 

1 — memory resident 

2 - real-time disc-resident 

3 - background disc-resident 

4 — not used 

5 — background segment 

6 - library, re-entrant or privileged (Note that 

these routines are relocated into the memory 
resident library if called by a memory resi- 
dent program. If not called by a memory 
resident program, they become type 7.) 

7 — library, utility 

8 - if program is a main, it is deleted from the 

system 

— or — 

8 — if program is a subroutine, then it is used 
to satisfy any external references during 
generation. However, it is loaded in the 
relocatable library area of the disc. 
1 4 - same as type 6 but automatically included 
in the resident library 



The primary type may be expanded in some cases by adding 
8 or 16 to the number. These expanded types allow such 
features as access to real-time common by background 
programs and access to SSGA. See Appendix I for a list 
of expanded program types. 



priority 



execution 
interval 



res 



is the program priority from 1 to 32767 with 
1 the highest priority 

is a Hst of six parameters (shown below) 
specifying the times the program should be 
scheduled for execution, once it is turned on. 
The first two values specify the execution inter- 
val, and the last four specify an initial absolute 
starting time : 

fresf, multf, hour, min, sec, 1 0msec] ] ] 

resolution code (0 to 4): 

- no execution interval 

1 - tens of milliseconds 

2 — seconds 



mult 



3 — minutes 

4 - hours 

execution multiple (0 to 4095); the resolution 
code gives the units for the execution multiple. 



hour,min, initial absolute starting time (four values): 

sec, 

1 0msec hours (0-23) 

minutes (0-59) 

seconds (0-59) 

tens of milliseconds (0-99) 

Fill in the blanks on the worksheet for any programs that 
are to be modified. 

STEP 1 5 - The next set of blanks are for creating and 
modifying type 3 (absolute) and 4 (replace) entry (ENT) 
records. Each ENT record takes the following form: 



Where 

entry 

type 

value 



entry, type, value 



is the entry point name. 

is the entry point type. 
AB = Absolute 
RP = Replace 

is the entry point instruction value. Octal 
numbers are assumed unless the letter "D" 
follows the number which signifies decimal. 



When an entry point is declared absolute (type = AB) its 
value is added to the referencing instruction to obtain the 
final instruction value. 



When an entry point is declared as replace (type = RP) the 
loader will replace each reference to it with the octal (or 
decimal) value. For example: 



.FMP,RP,1 05040 



This would cause each JSB .FMP instruction (floating point 
multiply) to be changed to the microcode floating point 
multiply instruction (105040). Other floating point (or 
fixed point EAU) type instructions that could be entered 
are: 
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Floating Point 

•FAD, RP, 105000 - Add 

.FSB, RP, 105020 - Subtract 

•FMP, RP, 105040 - Multiply 

•FDV, RP, 105060 - Divide 

IFIX, RP, 105100 - Fix 

FLOAT, RP, 105120 - Float 



Fixed Point 

.MPY,RP, 100200 

•DIV, RP, 100400 

.DLD,RP, 104200 

.DST,RP, 104400 



Other uses include I/O configuration at load time, and con- 
figuring tables that are assembled as DBF statements to 
externals. 

If you have loaded DVR32 into your system for the HP 
7905 MH Disc, you may take advantage of the move words 
microcode by making the following entry point change: 

.MVW, RP, 105777 

If you want to protect the FMP peripheral cartridges from 
alteration by user programs, you may enter a change to an 
entry point when the generator issues the prompt CHANGE 
ENTS?. To protect these cartridges, specify: 

$PDSK,AB,1 



STEP 16 — The next item on the worksheet concerns 
blank ID segments. One blank ID segment is required for 
each program that will be loaded into the system on-line by 
the RTE-III relocating loader. If five ID segments are 
allocated, then only five additional programs can be loaded 
at any one time into the system on-line. If a temporary pro- 
gram is deleted from the system by an 0F,name,8 operator 
command, or a permanent program is deleted from the 
system by the 0N,L0ADR„,4 command, the program's 
ID segment is returned to the system to use for another 
on-line load. Each disc resident program ID segment re- 
quires 29 words in the system memory resident area 
(28-word ID plus one key word). Fill in the number of 
blank ID segments required. (Note: is changed to 1 to 
allow loading at least one program.) Thfe total number of 
program ID segments, including memory resident and disc 
resident programs, is limited to 256. 

STEP 17 - The next item on the worksheet concerns 
blank background segment ID segments, or short ID 
segments. These ID segments require 10 words (9-word 
ID plus one key word) and are used only for background 
program segments. One short ID segment is required for 
each program segment. If an on-line load is done, and 
there are no blank short ID segments available, a regular 
29-word one will be used. 

STEP 18 - The maximum number of partitions (64) is 
determined by dividing up the pages remaining after SAM. 
Directions for dividing up the memory into partitions is 
found in Part 1 , Planning. Fill in the blank. 



STEP 19 - The next item on the worksheet is for the 
address of the first word available on base page for memory 
resident program links (FWA BP LINKAGE). This address 
must be above the last used I/O select code. It may be 
convenient to defer fiUing in this answer until step 26 has 
been completed. 

SYSTEM LOADING PHASE 

The System Loading Phase requires no user inputs. During 
this phase the system starts relocating the programs 
previously entered. 

TABLE GENERATION PHASE 

The Table Generation Phase is the part of the generation 
where the user builds the EQT table, LU table, interrupt 
table, and satisfies other system parameters. 

STEP 20 - The first blank in the Table Generation 
Phase concerns Class Input/Output numbers. Multiple 
terminal operation requires one Class Number; spooling 
requires two, and there must be one Class Number for each 
Class GET call simultaneously outstanding (see Section III). 
For example, if you specify ten Class Numbers here, ten 
programs can simultaneously process class requests. Enter 
a number between 1 and 255 (note that is changed to 1). 

STEP 21 - The next blank concerns a table (configured 
by the generator) called LU Mappings that cross reference 
real logical unit numbers to logical unit numbers within the 
Batch System. The number entered here is the table size 
and is related to the maximum number of logical unit 
numbers referred to in a single job within the Batch and 
Spool Monitor. A common entry would be ten. If the 
Batch and Spool Monitor is not used, zero can be entered 
but is defaulted to one. 

STEP 22 - The next blank concerns the allocation of 
Resource Numbers (RN's). Spooling requires four RN's and 
there must be one RN for each resource to be controlled. 
See the Resource Management Call in Section III. For ex- 
ample, if you specify ten RN numbers here, ten resources 
(e.g., I/O device or file) can be managed and used by cooper- 
ating programs. Enter a number between 1 and 255 (note 
thatO is changed to 1). 

STEP 23 - The next blank concerns current buffer 
hmits. Setting upper and lower memory limits here can 
prevent an inoperative or slow I/O device from monopoHzing 
available system memory. Each time a buffered I/O request 
is made (Class I/O requests are buffered), the system totals 
the lengths of all buffers for I/O requests queued to that 
EQT entry and compares the number to the upper Hmit 
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set here (or by the BL command). If the sum is less than 
the upper Hmit the new buffered request is added to the 
queue. If the sum is larger than the upper limit the re- 
questing program is suspended in the general wait (STATUS 
= 3) Hst. When a buffered I/O request completes, the sys- 
tem adds up the remaining words in I/O requests queued to 
that EQT entry and compares the number to the lower 
limit set here (or by the BL command). When the sum is 
less than the lower limit, any programs suspended for ex- 
ceeding the buffer limits on this EQT are rescheduled and 
may reattempt their request. A suggested entry of 100 and 
400 can be entered and later changed on-line with the BL 
command if desired. Note that programs with priorities of 
1 through 40 are not suspended for buffer limit, 

EQUIPMENT TABLE ENTRY (EQT TABLE) 

STEP 24 — The first table to be completed is the 
Equipment Table. Most entries are located on the I/O work- 
sheet and are transferred to this table. EQT number one 
should be the system disc and is either DVR31 for the 7900 
or DVR32 for the 7905. Note that each EQT entry con- 
tains a blank for the driver name which contains five char- 
acters, starts with the characters "DV" and ends with a 
two-digit octal number (e.g., DVynn). The entry point 
names are four characters in length and start with either 
"I" (e.g., Ixnn for initiation section), or "C" (Cxnn for 
Completion section), and usually end with the same two- 
digit octal number used in the driver name. However, since 
RTGEN does not examine the driver's NAM record, the 
driver may in fact be renamed to support more than one 
device type. The rules for the choice of "x" and "y" above 
are as follows: 

If "y" is not "R" then "x" = "y" 
If"y"is"R"then"x" = "-" 

Using the above rules, more than one driver with the same 
name can be configured into the system by changing the 
third character in the name. For example, the system has 
two Une printers of different types. Each Une printer uses 
a different driver but the drivers have the same common 
name, DVR12. Both drivers could be configured into the 
system by changing the name of one to DVA12. Its entry 
points for the Interrupt Table would then become lAl 2 
and CA12. The other driver would be DVR12 with entry 
points of 1.12 and C.12. The remaining blanks on the EQT 
entry line are for D (DMA required), B (buffered output), 
T (time-out), and X (extended EQT). The blanks are 
filled in as shown in the example in Figure 6-5. 

If T is specified, a value for T must be entered in the T = 
blank. The value must be a positive decimal number up to 
32767. This is then the number of time base generator 
interrupts (10 msec intervals), starting at I/O initiation for 
the device before which the device should have interrupted. 



(Note that for privileged drivers T must be long enough to 
cover the period from I/O initiation to transfer completion.) 
If the device has not interrupted by this time, it is consid- 
ered to have timed-out and is set down, except in the case 
of the system teletype and devices controlled by drivers 
handling their own time-out. For a device controlled by 
driver DVROO (e.g., teleprinter), or DVR05 (DVR05 re- 
served for future system control device), T should not be 
less than 500. Also, devices controlled by DVROO require 
special subchannel assignments to make the time-out 
feature effective. Refer to the DVROO Small Programs 
Manual, HP Part No. 29029-95001 . 

If "X" is specified (on the I/O Configuration Worksheet) a 
value for "X" must be entered in the "X" = blank. The 
value must be a positive decimal number up to three digits. 
This number of words of buffer space is appended to the 
EQT for the driver's use, and is called an EQT extension. 
The result of this entry is recorded in the driver's EQT 
table, words 12 and 13. EQT word 12 contains the number 
of words of buffer space, and word 1 3 contains a pointer 
to the buffer. An example use of the EQT extension is for 
the Batch and Spool Monitor Driver DVS43. An entry 
must be made for each spool file that will be active, or cur- 
rently doing I/O. For example, assume 6 files can be active 
at one time. The entries (referencing unused I/O slots) 
might be: 



30,DVS43,X 
31,DVS32,X 
32,DVS43,X 
33,DVS43,X 
34,DVS43,X 
35,DVS43,X 



18 
18 
18 
18 
18 
18 



Refer to the I/O Worksheet (Table 6-3) and write in the 
octal select code number, DVR number, and D,B,T, and 
X options if applicable, for each EQT number in sequential 
order. Note that the driver's identifying suffix letter is not 
included. An EQT entry specifying a non-existent (not 
loaded) driver results in generator error ERR 25. 



DEVICE REFERENCE TABLE (DRT TABLE) 

STEP 25 - The Device Reference Table, which contains 
the logical unit (LU) numbers, is cross referenced to the EQT 
entries here. Refer to the I/O Worksheet (Table 6-3) to 
obtain the EQT entry number, LU number, and subchannel 
number. Fill in the blanks as shown in Figure 6-6. LUO (bit 
bucket) is a system mechanism that allows immediate I/O 
completion (i.e. data buffer is written to or read from a 
non-existent device) The first seven LU numbers are reserved 
for system devices as follows: 
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Equipment 

Table 

Number 

Octal 

Select 

Code 

Number 

(slot) 

Driver 

Number 

Name 

Output 
Buffering 
Requested 
(B) 

Direct 
Memory 
Access 
Requiried 
(DMA) 
(D) 

Number 
of 1 ms. I 
Increments I 
Before j 

Timeout I 
T=n / 



-EOT 7 = ? 
17, DVR23, 



D, 



T = 200, 

A 






X = 150 



Number 
of Words 
For 

Extended 
Memory 



TPRTE-14 



Figure 6-5. EQT Table Example 
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LUO — Bit bucket (no entry required) 
LUl — System console 
LU2 - System mass storage 
LU3 — Auxiliary mass storage 
LU4 — Standard output device 
LU5 — Standard input unit 
LU6 — Standard list unit 



LU8 — Recommended for magnetic tape 



Extra LU numbers can be assigned using EQT number zero 
and may be changed on-line to reference other EQT's as 
desired. 



Octal 
Select 
Code 
Number 



Option 



Equipment 
Table 
Number 
— or— 
Entry 



21, EQT, 1 



TPRTE-16 



Figure 6-7. INT Table Example 



Decimal 
Logical 
Unit 
Number 

Equipment 

Table 

Number 

Subchannel 
Number 



-2 = EOT No.? 



option directs the system in handling the interrupt; there 
are four options: 



1,1 

it 



TPRTE-15 



Figure 6-6. DRT Table Example 

INTERRUPT TABLE (INT TABLE) 

STEP 26 — This table allows the user to establish interrupt 
links that tie the octal select codes back to EQT numbers. 
Each I/O card (select code), in ascending order, is referenced 
back to its EQT entry number that was established in the 
Equipment Table Entry part. If dummy I/O slots were used 
to reference EQT numbers for the Batch and Spool Monitor 
Driver DVS43 , interrupt links for those entries are also 
necessary. For example (refer to the sample generation in 
Appendix C), EQT number one (the first entry) was assigned 
to I/O slot 21 , DVR31 . Now, in the interrupt table, I/O slot 
21 will be referenced back to EQT number one. In this 
manner, an interrupt occurring on I/O slot 21 will be 
directed to EQT number one which has the address of 
DVR31 and that driver will be entered. The format for the 
entry is shown in Figure 6-7. 

Refer to Figure 6-7 and construct the entries for the inter- 
rupt table as follows: 

octal select code number is taken from I/O Worksheet 
(Table 6-3) in ascending order. 



relates channel to EQT 
entry n2. 

causes program name to be 
scheduled upon interrupt. 

causes control to transfer to 
the entry point of a user- 
written system program upon 
interrupt. 

Places the absolute octal value 
xxxxxx (instruction code) in 
the interrupt location. Do not 
place anything other than a 
JMP or JSB in the trap cell 
(see Appendix I). 



The 7900 disc controller I/O cards both require an interrupt 
link to their EQT entry number. Reference the select code 
numbers to the DVR31 EQT entry number as shown below. 



select code,EQT,n2 
select code,?RG /lame 
select code,ENT , entry 

select code, ABS, xxxxxx 



21,EQT,1 
22,EQT,1 



For other devices or subsystems that have more than one I/O 
card, refer to the I/O card or subsystem documentation 
covering the device and driver. In all cases, each I/O card 
must have an interrupt entry. Note that interrupt location 4 
(power fail) may be changed from its present HLT 4 to an 
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ENT entry if a power-fail routine is to be included in the 
system. For example: 

4,ENT,$P0WR 

where $POWR is an entry point in the power-fail routine. 

PROGRAM LOADING PHASE 

Planning generation responses may be difficult beyond this 
point since some of the responses are based on data not yet 
known. Examining the worksheet shows that the generator 
relocates the Hbrary and SSGA area, printing out boundaries 
and requesting changes. The merits of changing these bound- 
aries is discussed in Part 1 , Planning. The remainder of this 
part may therefore be used as a reference in planning, and 
during generation. 

STEP 27 — The library and SSGA areas are relocated. 
Real-time common default size is printed in decimal words. 
Enter the real-time common size desired in decimal words, 
or (zero) for no change (only increases are allowed). The 
first word available (FWA) of real-time common is then 
printed. 

STEP 28 — In this step the background default size is 
printed in decimal words. Enter the background common 
size desired in decimal words, or (zero) for no change 
(only increases are allowed). The first word available (FWA) 
of background common is printed. 

STEP 29 — The last word available (LWA) of background 
common is printed and the user is asked if he wants to align 
the end of common at the next page boundary (for protect- 
ion of memory resident programs). Enter YES to align the 
end of common to the next page boundary. The updated 
last word address of background common is printed. 

PARTITION DEFINITION PHASE 

After answering the last question the generator relocates 
memory resident programs, real-time disc resident programs, 
and background disc resident programs. When these pro- 
grams are all relocated, the generator print the name of 
each disc resident program and how many pages in memory 
they occupy (including base page). The largest addressable 
partitions, both with common and without common, are 
also listed. Partitions larger than these numbers can be de- 
clared, but the extra pages will not be accessable. 

STEP 30 — The last word address of the memory resident 
program area is printed and the user is asked if he wants to 
align the end of the area to the next page boundary (for 
protection of the system available memory). Note that those 



words skipped are wasted. Enter YES to aUgn the end of the 
memory resident program area to the next page boundary. 
If YES is entered, the generator automatically allocates one 
page of memory to the system available memory (SAM) 
area. If NO is entered, the generator allocates that area 
between the last word of the memory resident program 
area and the next page boundary, to SAM (this could be 
between 1 and 1024 words. The updated first word address 
of SAM is printed. The generator then prints the size of 
SAM. 

STEP 3 1 — The first page available for disc partitions is 
printed and is the page boundary that ends SAM. The user 
may increase this number which increases the area (in pages) 
for SAM . Enter a new decimal page number or (zero) for 
no change. The updated size of SAM, in decimal words, is 
then printed. 



STEP 32 - The decimal number of pages of physical 
memory remaining are printed. This area must be subdivided 
into real-time and/or background partitions. The sum of 
partition sizes must equal the number of remaining pages. 
Enter each partition description using the format described 
below. The last entry is /E. 



Format: part #, size, class [,RJ 

Where: part# is a number between 1 and maximum 
number of partitions (entered earher 
in step 18). This number is the "name" 
of the partition. 

size is partition size in decimal number of 
pages (a partition must include enough 
pages for a program plus one page for 
the program's base page) 

class is RT for real-time or BG for background 

R is reserved flag; if specified, partition 

may only be used by programs 
specifically assigned to it (see step 34 
below). 

The order in which partition definitions are entered is up to 
the user. Partition numbers may be skipped if desired; how- 
ever, pages win be assigned in order by partition number 
(lower numbered partitions get lower numbered pages). An 
example of defining the partitions is shown below: 

1,15,BG (partition no. 1, 15 pages, background) 
2,2,RT,R (partition no. 2, 2 pages, real-time, reserved) 
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STEP 33 — At this point the operator can modify disc 
resident program page requirements. The default size of each 
program was just prior to step 30 after the generator relocated 
the programs. This step allows the user to override the page 
requirements for those programs needing dynamic space for 
symbol tables or buffers. Refer to Table 6-5 for the standard 
RTE-III programs requiring a size override. Enter each disc 
resident program override using the format described below. 

Format: program name, pages 

Where: program is the name of the program 
name 

pages is the decimal number of pages re- 

quired to run this program (include 
one page for base page). 

An example of entering the program override is shown below: 

EDITR,8 

The edit program EDITR is assigned 8 pages and will not be 
run in a partition with less than that number. 



STEP 34 — The last step in the generation is assigning 
programs to run in a specific partition. Enter only those 
programs you wish to assign to a partition using the format 
described below with /E as the last entry. 

Format: program name, part # 

Where: program is the name of the program 
name 

part# is a number between 1 and maximum 

number of partitions (entered 
earlier) 

An example of assigning programs to partitions is shown 
below: 

HENRY,1 

The program HENRY will run only in partition number 1 . 

This concludes the operator inputs to the generator. The 
last thing the generator prints is the message that the system 
is stored on the disc and how many tracks and sectors it 
used. 
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Table 6-6. Generator Input Worksheet 



INITIALIZATION PHASE 



(1) 



(3) 



(4) 



(5) 



(7) 



7900/7901 DISC 

MH DISCCHNL? 



#TRKS, FIRST TRK ON SUBCHNL: 
0? 



7905 DISC 

CONTROLLER CHAN 

#TRKS, FIRST CYL #, HEAD, # SURFACES, UNIT, # SPARES FOR SUBCNL: 
0? 



(8) 



FG CORE LOCK? 



BG CORE LOCK? 



■128 WORD SECTORS/TRACK? 



SYSTEM SUBCHNL? 



SCRATCH SUBCHNL? 



AUX DISC (YES OR NO OR #TRKS)? 



START SCRATCH? 



(6) TBG CHNL? 



PRIV. INT. CARD ADDR? 



PRIV. DRIVERS ACCESS COMMON? 



(9) SWAP DELAY? 



(10) MEM SIZE? 



(11) 



(12) 



PRGM INPT? 



LIBR INPT? 



PRAM INPT? 



INITIALIZE SUBCHNL: 



(13) PUNCH boot; 
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Table 6-6. Generator Input Worksheet (Continued) 



PROGRAM INPUT PHASE 

CORE RESIDENT SYSTEM 

I/O DRIVERS 

USER'S SYSTEM PROGRAMS 

FOREGROUND CORE RESIDENT PROGRAMS 

FOREGROUND DISC RESIDENT PROGRAMS 

BACKGROUND CORE RESIDENT PROGRAMS 

BACKGROUND DISC RESIDENT PROGRAMS 

AND THEIR RESPECTIVE SEGMENTS 
LIBRARY PROGRAMS 
UTILITY PROGRAMS 
SUBROUTINES 



NOUNDEF EXTS 



PARAMETER INPUT PHASE 

ifAi NAME, TYPE [,PR [, RES [, MULT [, HR, MIN, SEC, 
10'S/MS]]]] 



/E 
(15) CHANGE ENTS? 



/E 



(16) #0F BLANK ID SEGMENTS: 



#0F BLANK BG SEG. ID SEGMENTS? 



(17) 



(18) 



(19) 



MAX NUMBER OF PARTITIONS? 



FWA BP LINKAGE? 



SYSTEM LOADING PHASE 
(NO USER INPUT) 



TABLE GENERATION PHASE 

*#0F I/O CLASSES? 



(20) 



(21) 



(22) 



(23) 



* #0F LU MAPPINGS? 



#0F RESOURCE NUMBERS? 



BUFFER LIMITS (LOW, HIGH)? 



EQUIPMENT TABLE ENTRY 
EOT 01? 
DV 



(24) < 



EOT 02? 



EOT 03? 



EOT 04? 



DV 



jav_ 



, DV 



EOT 05? 



■ DV 



EOT 06? 



.,i2V_ 



EOT 07? 



mL 



EOT 08? 



-,J2V_ 



EOT 09? 



EOT 10? 



J2V_ 



DV 



■ T= . X = 



T = .X = 



, T= ,X^ 



, T = . X = 



,T = ,X 



.,X.s X_ 



,T= .X 



.,X^ Kjl. 



.T = X 



/E 



TPRTE-22a 
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Table 6-6, Generator Input Worksheet (Continued) 



' 'DEVICE REFERENCE TABLE 

1 = EOT #? (SYSTEM TELEPRINTER) 



(25) < 



2 = EQT # ? (SYSTEM MASS STORAGE) 



3 = EQT #? (AUXILIARY MASS STORAGE) 



4=EQT#? (STANDARD PUNCH UNIT) 



5=EQT#? (STANDARD INPUT UNIT) 



6 = EQT #? (STANDARD LIST UNIT) 



7 = EQT #? 



8=EQT#? (MAG TAPE RECOMMENDED) 



9 = EQT # ? 



10 = EQT #? 



1 1 = EQT # ? 



12 = EQT #? 



13 = EQT #1 



14 = EQT #? 



15 = EQT #? 



/E 



(26) < 



• INTERRUPT TABLE 



/E 



TPRTE-22b 
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RT COMMON XXXXX 



(27) 



CHANGE RT COMMON? 



Table 6-6. Generator Input Worksheet (Continued) 

MODIFY PROGRAM PAGE REQUIREMENTS? 



RT COMMON XXXXX 

(28) BG COMMON XXXXX 

CHANGE BG COMMON? 



BG COMMON XXXXX 
(29) LWA BG COMMON XXXXX 
ALIGN AT NEXT PAGE? 



(30) 



LWA BG COMMON XXXXX 
PARTITION DEFINITION PHASE 

LWA MEM RESIDENT PROG AREA XXXXX 
ALIGN AT NEXT PAGE? 



(31) 



LWA MEM RESIDENT PROG AREA XXXXX 
SYS AV MEM; XXXXX WORDS 
1STDSKPG XXXXX 
CHANGE 1ST DSK PG? 



SYS AV MEM; XXXXX WORDS 
PAGE REMAINING: XXXXX 



(32) < 



DEFINE PARTITIONS 



(33) < 



(34) < 



/E 



ASSIGN PROGRAM PARTITIONS? 



/E 

SYSTEM STORED ON DISC 
SYS SIZE: . TRKS: 



SECS (10) 



/E 
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PART 3 

Performing System Generation 



The final part of this section provides directions on 
running the system generation program RTGEN, to con- 
figure the system planned in Parts 1 and 2. The operation 
of the generator is presented, followed by a step-by-step 
discussion of the sample generation listing in Appendix C, 
and details of starting-up the newly configured system. 
RTGEN error messages are explained at the end of part 3. 

It is assumed that the user has planned his configuration 
and responses to generator questions with the aid of parts 
1 and 2 of this section. Most of the answers required during 
generation will be taken directly from the worksheets. 

COMPUTER CONFIGURATION 

RTGEN will run on the same minimum configuration as 
required for an RTE-III system. The system disc controller 
must have the same select code during generation to be 
used in the RTE-III system being generated. (The Dynamic 
Mapping System and instructions unique to 21 MX series 
computers are not required during generation). 

GENERATOR FEATURES 



SWITCH REGISTER OPTIONS 

Several generation options (see Table 6-7) are selected by 
setting bits in the switch register. The switch register 
should be set before starting RTGEN and checked when 
restarting after an error. The switch register setting may 
be altered during generation at any time to reflect the 
user's changing requirements. This ability provides, for 
example, control over the amount of information Usted 
during program relocation. Refer to the heading, "Sample 
Generation," for details on switch register usage during 
the program input phase. 

HALTS 

The generator normally halts in several places with the 
code 102077 in the memory data register. The message, 
"HALT 77 - SET SWR AND PRESS RUN", is dis- 
played on the Ust device to notify the operator of the halt 
and the opportunity to change switch register (SWR) 



settings. (Several error halts are possible and are discussed 
at the end of this part). 

CURRENT PAGE LINKING 

Bit 14 of the switch register enables the current page 
linking option during module relocation. With this bit set, 
as each module is loaded it is checked to see if it crosses a 
page boundary. If it does, a linkage buffer is created before 
and after the module. Instructions which reference locations 
outside their own page are Unked indirectly through an 
address in one of these buffers. If no buffer exists on the 
referencing page, if the buffer overflows, or if the link is 
to an external entry point, base page links are used. 

The current page linking mechanism is desirable when base 
page space is critical. The program size is increased while 
the base page requirement is decreased. It might be desire- 
able, for example, to enable this option only while the 
system and library modules are being loaded, since these 
base page links reduce the amount available to disc and 
memory resident programs. 

NOTE 

EXT references and Assembly Language type 3 or 
5 programs still use base page exclusively when 
estabhshing hnks. However, this is not true for 
subroutines referenced by these programs. 

RESPONSES AND COMMENTS 

Normal responses are entered as a line, left-justified, and 
followed by a carriage-return, line feed (CR, LP) sequence. 
A response in error is corrected by entering a "rubout" 
followed by CR,LF then retyping the response. Whenever 
a response is expected, one or more comments may be 
entered followed by the response line. A comment begins 
with an asterisk (*) and ends with CR,LF. A comment 
may also follow a response on the same line, with at least 
one blank separating the response and the comment. 
Comments are useful for documentation purposes and when 
switching response input from console to paper tape as 
discussed below, under "ANSWER TAPE." 
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ERROR MESSAGES 

The generator produces numbered error messages of the 
form, "ERR XX," where XX is a two digit decimal 
number. These messages are presented along with their 
meanings and the appropriate action at the end of part 3. 
Note that after an error, the next response is read from the 
operator's console, even if the previous responses had been 
through paper tape. 

NUMBER SYSTEMS 

The generator uses octal (base 8) numbers when listing 
word addresses (including interrupt trap cell locations and 
device select codes). Responses specifying addresses must 
be made in octal. All other quantities, including page 
addresses, are expressed in decimal. 



ANSWER TAPE 

If desired, a paper tape may be prepared consisting of all 
(or some of) the responses to be entered during generation. 
Each response should be left-justified in a line which ends 
with carriage-return, line-feed (CR,LF). By selecting the 
appropriate switch register option, the paper tape is read 
rather than the console keyboard when a response is 
required. 

If relocatable programs are to be entered from paper tape, 
leave a gap (a few inches of null characters) for visual 
identification just before starting the Parameter Phase 
responses. When the generator halts after the Initialization 
Phase, remove the answer-tape and proceed with the program 
Input Phase. After reading the last relocatable tape, replace 
the answer tape in the photoreader and position the gap 
under the read head after reading the final program tape. 

When RTGEN halts (for example, at the start of the 
Partition Definition Phase), the operator has a convenient 
point at which to change from paper tape back to console 
responses and proceed interactively. 

If a particular response is not known in advance when 
punching the answer tape, and a halt is not conveniently 
near, punch a response with a known error on the tape at 
the spot you wish to stop. When the error is encountered, 
control automatically reverts to the keyboard. The operator 
can then enter the correct response before continuing with 
the answer-tape. If several responses are to be entered inter- 
actively, turn off the answer-tape option in the switch 
register before entering the corrected response; further 
responses will then be read from the keyboard. To revert 
back to the tape, wait until a response on tape is needed, 



then set the answer tape bit in the switch register (position 
the tape if necessary), and enter a "comment" response 
{*comment) through the console. 

RESTARTING 

If an error is discovered by the user after a response has 
been entered, or if RTGEN reports an uncorrectable 
error, it may be possible to restart the generator at some 
earlier point without reloading the program. Restart is 
accomplished by setting the program address to octal 
location 100 and pressing RUN. RTGEN will resume pro- 
cessing at the beginning of the most recently passed of 4 
possible phases: either Initialization, Program Input, 
Parameter, or Partition Definition. Restarts after the final 
"/E" response at the end of the Partition Definition Phase 
are not allowed and will result in an irrecoverable error 
message. This is because RTGEN is involved in clean-up 
operations which cannot be repeated without reinitializing. 

To restart the generator follow these steps: 

a. Halt the computer and set the program address to 
resume at octal 100. 

b. Check switch register options and make sure it apply s to 
the restart point. 

c. Position the answer-tape (if used). 

d. Press Run 

e. If using an answer-tape and restarting after an error 
message, it may be necessary to type a comment ("*") 
at the console to get the tape started. 

GENERATOR INPUT/OUTPUT 

With the exception of the disc, I/O operations to peripheral 
devices are carried out through SIO drivers. The System 
Input/Output drivers must be configured as described in 
the SIO System Configuration Manual. The following 
devices require SIO drivers if used: 

Teletype — required. 

Line printer — optional. If used, all teletype output goes 
to the line printer. 

Photoreader — optional. For program/response input. 

Punch — optional. For punching bootstrap and/or 

echoing questions and responses. 



Mag Tape 



optional. For program input. 



The configured SIO drivers may be punched as a single 
absolute tape for subsequent generations. 
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PREPARING RELOCATABLE TAPES 

Relocatable modules should be loaded during the program 
input phase in the order shown below. Users with a magnetic 
tape unit may choose to prepare a tape containing all or 
most relocatables before starting the generation. Follow the 
instructions given in the Prepare Tape System Manual (HP 
Part No. 02 1 1 6-9 1751). The instructions given in the manual 
for DSGEN apply directly to RTGEN. 

In Section III of the PTS Manual under Operating 
Instructions, substitute the following information under 
step 1. 

1 . Gather all the relocatable system and user program tapes. 
The suggested order for loading onto the magnetic tape. 

Memory Resident System 

I/O Drivers 

Power Fail (DVP 43) 

System Programs written by the user 

Multi-Terminal Monitor 

Memory Resident Programs 

Real-Time Disc-Resident Programs 

Assembler (Main and its Segments) 

FORTRAN (Main and its Segments) and or 

FORTRAN IV (Main and its Segments) but not both 

FORTRAN IV Versions 
ALGOL 
Auto Restart 
Relocating Loader 
Editor 

Batch Monitor 
Other Background Disc-Resident Programs and their 

respective segments, if any. 
System Library 
Batch Monitor Library 
Library Programs 
Utility Programs 

NOTE 

Some of the above relocatable modules may not be 
present in some configurations. 

GENERATOR START-UP 

The following steps begin the generation of the RTE-III 
system: 

a. Apply power to all equipment. Insert any removable disc 
cartridges to be used into the disc drive. Refer to the 
appropriate disc drive hardware manual and disable any 
protection mechanisms on the discs to be configured 
during the generation. 

b. Refer to the 21MX Computer Reference Manual, HP Part 
No. 02108-90002 for the computer under "cold start" 
and load the appropriate RTGEN tape through the photo- 
reader; 92060-16029 for HP 7900, 92060-16032 for HP 
7905. Similarly, load the configured SIO drivers (or load 
and configure individually). Note that if a magnetic tape 
SIO driver is used, it must be loaded last (after the gener- 
ator and other SIO drivers). 



c. Study Table 6-7 and set the switch register for any 
desired initial options. Most options can be preset at the 
beginning even though not used until later. Note that 
during the Program Input Phase, bit 15 may need to be 
changed if an error occurs, and bits and 1 will require 
attention at least once in that phase. 

d. Place the answer tape (if used) in the photoreader. 

e. Set the starting address of the program to octal 100 
and press RUN to start. 

When RUN is pushed RTGEN begins asking questions on 
the input device. After each question is printed, the 
operator responds with the required answer as previously 
described. 



SAMPLE GENERATION 

The following pages discuss an actual RTE-III generation in 
a step-by-step procedure where the system is configured 
on an HP 7900 Moving Head Disc. Note that the first two 
questions would be different if the disc were a 7905. Refer 
to Part 2 steps 1 and 2 for the difference. 

The listing, or generator printout, is included in this 
manual as Appendix C. 

RTGEN requests the higher priority select code (octal) of 
the system disc controller 

MH DISC CHNL? 

RTGEN requests the starting track and number of tracks 
(decimal) of each subchannel that will be assigned to the 
system. Up to eight track assignments can be entered, one 
for each existing subchannel. The even numbered subchan- 
nels are the fixed platters and the odd numbered subchan- 
nels are the removable platters (i.e., subchannel is the 
fixed platter and subchannel 1 is the removable platter of 
the first drive. 

#TRKS, FIRST TRK ON SUBCHNL: 

0? 

Operator responds with the decimal number of tracks and 
starting track number for subchannel 0. If there are no 
tracks from subchannel assigned to the system, enter a 
0. RTGEN continues to request the track assignments for 
each subchannel up to seven or until /E is entered. 

0? 
203,0 

1? 
203,0 

2? 
203,0 

3? 
203,0 

4? 
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Table 6-7. Switch Register Options 



Bit 


Function 


When to Set 


15 


1 = The program just read will be purged. Input data is ignored 
until the next NAM record. The same program starting from 
the beginning or the next program will then be read. 

= The program just read is not purged. The last record can be 
re-read. 


After error 2, 3, or 4 during 
the Program Input Phase 


Print the entry point list. 


Before answering FWA BP 
LINKAGE? (change any time) 


14 


Establishes current page-linking mode. 


Before answering FWA BP 
LINKAGE? (change any time) 


13 


Print base page linkage Hsting. 


Before answering FWA BP 
LINKAGE? (change any time) 


6 


Print only errors on list device. The generation printout is 
omitted. 


Anytime 


5 


Answers are read from the tape reader instead of the teletype. If 
an input error occurs, control is automatically returned to the 
teletype for the next command only. If the error is meaningless 
(e.g., an unwanted routine is referenced), input from the tape 
reader can be resumed by entering an asterisk (followed by any 
comments if desired) and carriage return, line feed. The switch 
can be turned off at this time in order to enter multiple inputs 
from the TTY. 


Beginning/during 
generation 


4 


Questions and answers are punched on the punch device. 


Beginning/ during generation 


3 


Questions and answers are printed on the Ust device. This assumes 
the Ust device is a line printer because RTGEN will list to only 
one device. 


Beginning/during 
generation 


1 



Switches 1 and are set as follows: 
1 Meaning 

Load from program input unit 

1 Load from library input unit 

1 Print list of undefined externals and halt. 

1 1 If still set terminate program Input Phase. 


Beginning of generation 
and during Program 
Input Phase 


NOTES 

1. When answers are from the photoreader, and an error occurs, the generator transfers control to the keyboard 
automatically. Type in the correct answer or a comment to continue (ignoring the error). 

2. A comment must be prefaced with an asterisk. Comments may appear at the end of any input line and may 
be the only thing on a Hne. 

3. The switch setting is examined each time the action it controls is started. Thus the setting may be examined 
at any time. 
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!00,50 

5? 
203,0 

6? 

7? 



RTGEN requests the number of 128 word sectors (dec- 
imal) per logical track on the system disc. 



# 128 WORD SECTORS/TRACK? 

Wm 



SCRATCH SUBCHNL? 


RTGEN asks if there is to be an auxiliary disc (LU3) and its 
number of tracks. YES means there is an auxiliary disc 
and it's on the same controller as the system disc. Answer 
NO if there is no auxiliary disc. Answer with the number of 
tracks if there is an auxiliary disc and its not on the same 
controller as the system disc. 

AUX DISC (YES OR NO OR # OF TRKS)? 

SMI 

If the above question had been answered with a number de- 
noting how many tracks on the auxihary disc (on a different 
controller than the system disc), then the next question asked 
would have been: 

# 128 WORD SECTORS/TRACK? 



NOTE 

The following two questions con- 
cerning system subchannel and 
scratch disc subchannel are not 
asked if only one subchannel is as- 
signed to the system. 



If the answer to the AUX DISC? question was NO, then 
RTGEN skips to the START SCRATCH? question. Since the 
answer to the AUX DISC? question was YES, RTGEN 

requests the auxiliary disc subchannel number. The 
operator responds with a vahd subchannel number (not the 
system subchannel). 

AUX DISC SUBCHNL? 

iil 



RTGEN requests the subchannel number of the system disc 
(LU2). This is the disc that the absolute code will be stored 
upon and can be any one of the subchannels assigned to the 
system. The operator responds with a subchannel number 
(from the worksheet) that contains enough tracks for the 
absolute code. 



SYSTEM SUBCHNL? 

RTGEN requests the subchannel number of the scratch 
disc. This is the area required for the relocatable modules 
used to build the system, and can be any one of the sub- 
channels assigned to the system. It is recommended that the 
scratch area not be located on the system subchannel. Then 
the absolute area cannot overlay the relocatable modules 
before they are used. 



RTGEN requests the track number starting the disc scratch 
area. The operator responds with a decimal relative track 
number. For example, subchannel 4 has tracks addressed 50 
to 150 available. To start the scratch area on the first avail- 
able track (50) enter a zero (0). To start the scratch at track 
75, enter 25. Note that if the scratch subchannel is the 
same as the system subchannel, entering a zero defaults the 
start scratch to the midpoint of the "available disc space on 
the system subchannel. 

START SCRATCH? 


RTGEN requests the select code of the time base generator 
(octal). 

TBG CHNL? 

13 

RTGEN requests the address of the privileged interrupt I/O 
card (if present). 
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PRIV. INT. CARD ADDR? 

Operator responds with the octal select code of the privi- 
leged interrupt HP 12620 card (and all devices in higher 
priority slots become privileged) or zero if the card is not 
used. 






RTGEN asks if the common area should be included in the 
System Map for access by privileged drivers. Answer YES 
or NO. 

PRIV. DRIVERS ACCESS COMMON? 



RTGEN requests the type of input unit for relocatable li- 
brary programs. 

LIBR INPT? 

Operator responds with PT, TY, or MT. 

PT 

NOTE 

Any type of program can be 
entered through the program input 
unit or the library input unit. 



RTGEN asks if any real-time disc resident program is allow- 
ed to be locked into memory. Answer YES or NO. 

RT CORE LOCK? 

fiiii 

RTGEN asks if any background disc resident program is 
allowed to be locked into memory. Answer YES or NO. 

BG CORE LOCK? 
YES 

RTGEN next requests the amount of swap delay time. En- 
ter a decimal number between and 255 (meaning tens of 
milliseconds). 

SWAP DELAY? 

RTGEN requests the size of physical memory in pages. 



MEM SIZE? 

Operator responds with the decimal number of pages in 
the system. 



64 



RTGEN requests the type of input unit for relocatable pro- 
gram modules. 

PRGM INPT? 

Operator responds with PT (for paper tape), TY (for tele- 
printer), or MT (for magnetic tape). 

Wil 
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RTGEN requests the type of input unit for parameters 
describing the relocatable programs. 

PRAM INPT? 

Operator responds with PT OR TY. Even though TY is 
specified, parameters will be read from an answer tape if 
the switch register is set appropriately. 



TY 



RTGEN asks if the operator wishes to initiaUze disc sub- 
channels other than the system, auxiliary, and scratch 
subchannel. RTGEN asks this question only for those 
subchannels assigned to the system but not declared as 
LU2, LU3, or scratch, these subchannels being 
automatically initialized by RTGEN. Operator responds 
with a YES or NO. If the disc is new or has any write 
protect flags written on it, it must be initialized. If the disc 
has data stored on it in the system designated area, and the 
user does not want to disturb it, the answer is NO. 

INITIALIZE SUBCHNL: 

2? 

HO 

3? 

NO 

4? 

NO 

5? 

NO 

6? 

NO 

7? 



If there are any bad tracks, they will be 
reported here. Refer to Part 2 step 12. 
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Next RTGEN checks the hardware disc protect switch. If 
the disc is protected RTGEN prints 

TURN OFF DISC PROTECT - PRESS RUN 

and halts with the Memory Data Register = 102032. The 
operator must turn off the disc protect switch and press 
RUN to continue to the next phase. If the switch is already 
off the above message is not printed and RTGEN proceeds 
to the PUNCH BOOT question. If the response to PGM 
INPT or LIB INPT was MT, the magnetic tape unit will 
rewind to the load point, and then space forward to relo- 
catable file number two. A HALT 102044 indicates that 
the magnetic tape unit is not ready. Set it up and press 
RUN. 

RTGEN asks if a paper tape bootstrap is to be punched. If 
the RTE-III System is located on subchannel or 1 and 
starts on track 0, the bootstrap tape is not required. Other- 
wise the first answer should be YES. Note that the boot- 
strap is unique to the first track of the system subchannel, 
amount of CPU space, and LU of the disc. RTGEN keeps 
repeating the question until NO is entered, then executes a 
HALT 102077. In this fashion the user can punch as many 
bootstraps as he feels he needs. 

PUNCH BOOT? 

YES 
PUNCH BOOT? 

NO 

PROGRAM INPUT PHASE 

During the program input phase, RTGEN accepts reloca- 
table programs from the program input unit and Ubrary 
input unit specified during the initiaUzation phase. The op- 
erator selects the input device by setting switch register bits 
and 1 . 

00 = program input unit 
10 = library input unit 

01 = print list of undefined externals, or after the 

printout 
01 = terminate input phase 

If an error is detected during the Program Input Phase, the 
name of the offending program is printed. At this point the 
operator can set or clear bit 15 before pushing RUN to 
accomplish one of the following: 

Bit 15 = 1 The program just read will be purged. Input 
data is ignored until the next NAM record. The 
next program will then be read. 

Bit 15 = The program just read is not purged. The last 
record can be re-read. 



Relocatable programs should be loaded in the following 
order. Note that some of the programs may not be present 
in some configurations. 

Memory Resident System 

I/O Drivers 

Power Fail (DVP 43) 

System Programs written by the user 

Multi-Terminal Monitor 

Memory Resident Programs 

Real-Time Disc Resident Programs 

Assembler (Main and its Segments) 

FORTRAN (Main and its Segments) and/or 

FORTRAN IV (Main and its Segments) but not both 

FORTRAN IV Versions 
ALGOL 
Auto Restart 
Relocating Loader 
Editor 

Batch Monitor 

Other Background Disc-Resident Programs and their respec- 
tive segments, if any. 
System Library 
Batch Monitor Library 
Library Programs 
Utility Programs 



NOTE 

If a program is being loaded from 
paper tape, and was not generated 
with the type code in the NAM 
record, the operator can modify 
it during the Parameter Input 
Phase. 

The operator presses RUN. After a program is loaded, the 
message "*EOT" is printed whenever an end-of-file or end- 
of-tape occurs. The computer halts. 

At this point, the operator has several alternatives: 

a. Additional programs can be loaded througli the 
same device by pushing RUN. 

b. Input can be switched to the other input device 
by setting the switch register bits to binary 00 or 10. 

c. After each *EOT message, a list of all unde- 
fined externals can be printed by setting the switch 
register bits to binary 01 and pushing RUN. At this 
point the operator can reset the switches to point to 
the desired input device, and load additional routines 
needed to satisfy any undefined externals. If there are 
none, the message NO UNDEF EXTS is printed and 
the computer executes a HALT 77. To continue load- 
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ing programs, reset the switch register to binary 00, 
or 10, place the program in the input device, and 
push RUN. 

d. To terminate the program input phase, set the 
switch register to binary 01 and push RUN. (RUN 
must be pushed again after NO UNDEF EXTS is 
printed.) If magnetic tape is used for the program 
input, it will rewind and go off-line at this point 
(after the second RUN). 

e. To restart this phase go to the starting address 
of the program, octal 100, set the switch register 
and push RUN. 

PARAMETER INPUT PHASE 

If the teletype was not specified as the PRAM INPT device 
during initiaHzation, the computer executes a HALT 77 to 
wait for the parameter tape to be inserted in the photo- 
reader. Push RUN to continue. If there are any errors on 
the parameter tape, they will be printed on the list device. 

During the parameter input phase, the operator can modify 
the type, priority, or execution intervals (in decimal) of any 
of the programs entered during the program input phase 
(except that the primary code of background main 
programs and their segments cannot be changed without 
losing their relationship to each other). 



CHANGE ENTS? 



*EAU MACRONS 
*HI?FMACliOS 



*ilAI»,KFjOS22a 

..DCM,EP405aM 
3yiDl>,RI»405207 

xmMM,im2w 

mmw^MS2u 
m 



Each parameter record is of this general form: 

name, type [,pnority] [, execution interval] 

Refer to the Configuration Worksheet and enter any modi- 
fication parameters that are listed. If there are none, enter a 
/E on the teletype. In the example (see Appendix C) the 
operator responds with: 



RTGEN requests the number of blank 28-word ID segments 
to be allocated for on-line loading of programs by the relo- 
cating loader. The operator responds with a one or two 
digit decimal number (zero is changed to one, because one 
is required to do any on-line loading); 29 words are reserved 
in the resident table area for each blank ID segment. 

# OF BLANK ID SEGMENTS? 

iiil 



fAUAumms 
mtzktxt 



RTGEN next requests the number of blank 9-word ID seg- 
ments to be allocated for background segments. The oper- 
ator responds with a one or two digit decimal number (zero 
is legal); 10 words are reserved in the resident table area for 
each blank BG ID segment. 

# OF BLANK BG SEG. ID SEGMENTS? 

Ill 



RTGEN requests if there are any entry records to be 
changed. The numbers are assumed octal unless followed by 
a "D" which signifies decimal. Note the comments 
prefaced by the asterisk. 



RTGEN requests the maximum decimal number of 
partitions to be defined so that table space (6 words each) 
may be set aside. 

MAX NUMBER OF PARTITIONS? 
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RTGEN requests the first word of available main memory in 
base page. Operator responds with the first available octal 
select code number after the last I/O card. 



NOTE 

The generator will begin system loading following 
this response. Any desired switch register options 
affecting relocation should be set before answer- 
ing. (These may be set at the beginning of 
generation.) 

FWA BP LINKAGE? 
100 

SYSTEM LOADING PHASE 

Disc loading begins with the modules of the system, includ- 
ing I/O drivers. As RTGEN loads these programs, it prints 
SYSTEM, followed by a memory map giving the starting 
locations and, if switch register bit 15 is set, the entry 
points for all main programs and subroutines (subroutines 
are indented two spaces). Also, if bit 13 is set, the base page 
Unkage is reported after each module is loaded. 

TABLE GENERATION PHASE 

After the last system module is loaded RTGEN requests 
how many Class I/O numbers are to be allocated. 

*# OF I/O CLASSES? 

RTGEN next requests the maximum number of logical unit 
numbers referred to in a single job within the Batch and 
Spool Monitor. 

*# of LU MAPPINGS? 



RTGEN next requests how many Resource Numbers are to 
be allocated. 

*# OF RESOURCE NUMBERS? 

RTGEN next requests the buffer limits. 

BUFFER LIMITS (LOW,HIGH)? 
100,400 

Next, RTGEN generates the three I/O tables: Equipment 
table, device reference table, and the interrupt table. 

RTGEN requests the equipment table entries 



* EQUIPMENT TABLE ENTRY 

Operator responds with a series of EQT entries, which are 
assigned EQT numbers sequentially from one as they are 
entered. The EQT entry relates the EQT number to an I/O 
channel and driver. Refer to the Configuration Worksheet 
and enter the Equipment table entries. The Appendix C 
example is entered as follows: 



EQT 01? 

EQT 02? 

15,0VjRl0O3,1^3a|i| 



EQT 03? 



EQT 04? 

i7^R023,T«3a|il 

EQT 05? 
16,DVR0I,T«32767 

EQT 06? 
20,DVR123,T-32767 

EQT 07? 
25,DVRO03*T^32767 

EQT 08? 
23,DVR13,D,B,T« 32767 

EQT 09? 
EQT 10? 



EQT 1 1 ? 
l4,DVRli,D 

EQT 12? 
304)VjaCK)3,T-32767 

EQT 13? 
314>VK00,B,T«32767 

EQT 14? 
32,DVR0O,B»T*=32767 

EQT 15? 
33,DVR003,T^32767 

EQT 16? 

EQT 17? 
35,DVR00,BJ«*32?67 
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EQT 18? 

EQT 19? 
373>VR003,T=32767 

EQT 20? 
72,DV$43PC«1$ 

EQT 21? 

7%ms4^:K^m 

EQT 22? 

EOT 23? 
75,DVS43^=ia 

EQT 24? 
76,DVS43^«i$ 

EQT 25? 
774)V$43;>(*J8 

EQT 26? 
4,DW43 

EQT 27? 



RTGEN requests the logical unit number assignments for the 
device reference table. 

*DEVICE REFERENCE TABLE 

For each logical unit number, RTGEN prints 

«=EQT#? 

where « is a decimal integer starting with one. 

Operator responds with an EQT entry number appropriate 
to the standard definition of n and the subchannel number 
if appropriate. Logical unit numbers through 6 are pre- 
defined in the system as: 



* DEVICE REFERENCE TABLE 

* SYSTEM CONSOLE 



1 = EQT #? 
10 



bit bucket (no action allowed) 
system console 
system mass storage 
auxiliary mass storage 
standard output device 
standard input unit 
standard list unit 



Refer to the Configuration Worksheet and enter the Device 
Reference Table entries. The Appendix C example is en- 
tered as follows: 
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2 = EQT #? 

3 = EQT #? 
1,1 

4 = EQT #? 

5 = EQT #? 

6 = EQT #? 
1 

7 = EQT #? 
I 

8 = EQT #? 

9 = EQT #? 
IO=EQT#? 
I I = EQT #? 

12 = E0T#? 

n 

13 = EQT#? 


14 = EQT #? 
ht 

15 = EQT#? 

16 = EQT#? 

17 = EQT#? 

18 = EQT#? 

19 = EQT#? 

20 = EQT #? 
12 



* system disc 
♦auxiliary disc 
*paper tape punch 
*photoreader 

•line PRINTER 
•background TEiyVlINAL 

•magnetic tape, unit 
*mag tape, unit 1 
*mag tape, unit 2 

*MAG tape, UNIT 3 
*CARD READER 

* BIT BUCKET 

•peripheral DISC 
*PERIPHERAL DISC 

•peripheral DISC 

•peripheral DISC 

•peripheral disc 

•peripheral DISC 

•terminal 
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21 = 


EQT #? 


:|B 




22 = 


EQT#? 


H 




23 = 


EQT #? 


■ 




24 = 


EQT#? 


16 




25 = 


EQT#? 


i|||: 


1 


26 = 


EQT #? 






27 = 


EQT#? 


•^^ 


1 


28 = 

Hi 


EQT#? 


29 = 



EQT #? 


30 = 


EQT #? 


B 




31 = 


^ EQT #? 


B 




32 = 


= EQT #? 


B 




33 = 



= EQT #? 


34 = 



= EQT #? 


35 = 



= EQT #? 


36 = 

■1 


= EQT #? 


37 = 

■ 


= EQT #? 


38 = 



= EQT #? 


39 = 



= EQT #? 


40 = 


= EQT #? 








•terminal 
♦terminal 

♦terminal 
♦terminal 
* terminal 
•terminal 
♦terminal 



H.P. 231 3B SUBSYSTEM 

'H.P. 6940 SUBSYSTEM 
'H.P.91200TVINTFC 



41=EQT#? 

■ 




42 = EQT #? 

iii 




43 = EQT #? 





44 = EQT #? 





45=EQT#? 




46 = EQT #? 

ii 




47 = EQT #? 

■ 




48 = EQT #? 

■ 




49 = EQT #? 




50 = EQT #? 

Ill 




51= EQT #? 


* SPOOL LU 


52 = EQT #? 


♦spool LU 


53 = EQT #? 

2a 


*SPOOL LU 


54 = EQT # 

23 


*SPOOL LU 


55 = EQT #? 

24 


♦spool LU 


56 = EQT #? 

25 


*SPOOL LU 


57 = EQT #? 
26 


*POWER FAIL 


58 = EQT #? 

/E 





RTGEN requests the interrupt table entries. 
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*INTERRUPT TABLE 

Operator responds with an entry for each I/O card, in as- 
cending order (except I/O location 4). 



Note that the entry for location 4 (power-fail) may be en- 
tered out of order. This is the only location allowed out of 
order. The Appendix C example is entered as follows: 

* INTERRUPT TAStE 

21»T4 

a4,BQTJ 
2S^KG]tmft 

27,EQT40 

3«|»RGJ?RMFt 

?2,BQT,20 

?a,EQT,21 
74^Qt,a2 
75TOT,23 

77jeQT,2$ 

PROGRAM LOADING PHASE 

The switch register setting affects current page linking for 
modules relocated in this phase and determines what infor- 
mation will be reported by the generator. 

The Memory Resident Library and the Subsystem Global 
Area (if any) are loaded first. SSGA is considered part of 
common for mapping purposes, and the remaining two 
common subareas are established next. 



RTGEN reports the default size of Real-time common 
(decimal) and asks for an override. 200 (decimal) words are 
requested in the sample. Enter for no change. 
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RT COMMON 00000 

CHANGE RT COMMON? 

The starting address (octal) of Real-time common is 
reported: 

RT COM 40755 

The same sequence is followed for Background common. In 
the sample 200 decimal words are requested. Enter for 
no change. 



BG COMMON 00000 
CHANGE BG COMMON? 
200 

The starting address of BG common is reported: 
BG COM 41265 

The last address in common is reported and the user is asked 
if it should be aligned at the next page boundary (alignment 
protects the upper neighbor, memory resident programs). 

LWABG COMMON 41574 

ALIGN AT NEXT PAGE? 

Since YES was entered, RTGEN reports the new last address 
of common. 

LWABG COMMON 41777 

Program loading (relocation) now continues with memory 
resident, real-time disc resident, and background disc 
resident programs. When finished, the computer will HALT. 

PARTITION DEFINITION PHASE 

Before beginning this phase by pushing RUN, check the 
switch register options (see Table 6-7) for a possible change 
(e.g. change from answer-tape to manual input through 
the console). The partition size requirements for Real-time 
and Background programs are listed. 

RT PARTITION REQMTS: 

SMP 04 PAGES 

JOB 04 PAGES 

WHZAT 02 PAGES 

AUTOR 04 PAGES 
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BG PARTITION REQMTS 


FMGR 06 


PAGES 


EDITR 05 


PAGES 


GASP 07 


PAGES 


ASMB 06 


PAGES 


XREF 05 


PAGES 



LOADR 06 PAGES 

The largest partition size which can be addressed by any 
program are reported (including base page). 

LARGEST ADDRESSABLE PARTITION: 

W/0 COM 16 PAGES 
W/ COM 16 PAGES 

The size and boundaries of System Available Memory 
(SAM) are established in the following sequence. SAM 
normally begins after the Memory Resident Program 
area. RTGEN reports the last word of the Memory 
Resident Program area and then asks if you want to align 
it at the next page boundary. If YES is answered, the 
beginning of SAM is aligned at the page boundary, not the 
end of the Memory Resident Program Area. That area in 
between the two is lost, if NO is answered, the beginning 
of SAM is aligned at the end of the Memory Resident 
Program Area and extends only to the next page 
boundary. Aligning the start of SAM at a page boundary 
affords SAM protection from unauthorized access. 

LWA MEM RESIDENT PROG AREA 45434 
ALIGN AT NEXT PAGE? 



Since YES was entered, RTGEN reports the new last 
address of the Memory Resident Program Area. 

LWA MEM RESIDENT PROG AREA 45777 

The default size of SAM is reported (decimal). Since the 
beginning of SAM was aUgned at a page boundary above, 
its default size is one page. 

SYS AV MEM: 01024 WORDS 



If the beginning of SAM had not been aligned at a page 
boundary, then the area for SAM would have been the 
number of words between LWA MEM RESIDENT PROG 
AREA and the next page address. 

The first page available for disc partitions ends System 
Available Memory. Refer to Figure 6-1. In the sample, this 



page number is increased by one page to add 1024 words to 
the default SAM size: 

1ST DSKPG 00020 
CHANGE 1ST DSKPG? 

The final size of SAM is reported as two pages. This is one 
page (default) plus the page just added. 

SYS AV MEM: 02048 WORDS 

The decimal number of pages remaining for disc partitions 
is reported and the operator divides this area into partitions: 

PAGES REMAINING: 00043 
DEFINE PARTITIONS 

RTGEN next allows the operator to override the page 
requirements for those programs needing dynamic space 
for symbol tables or buffers: 

MODIFY PROGRAM PAGE REQUIREMENTS? 
h$MBM , 



m 

The final entries assign specific programs to be run in 
specific partitions. No assignments wre made in the sample. 

ASSIGN PROGRAM PARTITIONS? 

■ 

The generation ends as the system size on disc is reported 
(size includes the system, and disc resident programs in 
memory-image format plus the relocatable library). 

SYSTEM STORED ON DISC 

SYS SIZE: 20 TRKS, 031 SECS (10) 

RTGEN halts. (The standard halt messa^ is printed even 
though the program does not continue from this point.) 
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INITIATING AN RTE-III SYSTEM 

The newly configured system is started up in the following 
steps: 

a. Turn-on any disc protection features which were dis- 
abled for generatioii. 

b. Refer to 21 MX the Computer Reference Manual HP Part 
No. 02108-90002 for program loading ("cold start") 
instructions. If the computer contains a build-in (e.g., 
ROM) disc loading program, execute it. If the disc boot 
is not built-in, use the paper tape bootstrap program to 
load the RTGEN boot punched during generation. Exe- 
cute the RTGEN boot starting at location 100 (octal). 



In either case, when the computer halts after the disc 
boot is executed, press run. 

c. The message "SET TIME" should appear on the 
operator console. 

d. File Manager initilization errors may be printed. For 
details on how to initialize the File Manager system, see 
Batch-Spool Monitor Reference Manual (92060-90013). 

e. The operator either sets the clock to current time 
using the TM operator request, or enters any other 
request (the system starts with time set to 8:00 on 
approximate release date). 



ERROR HALTS 



The following halts can occur during use of the bootstrap. 



102032 Disc protect switch 
in protect position. 

102044 Magnetic tape not 
ready. 

102066 Punch error 



102077 



Normal halt. 
Additional data 
required. 



Turn off switch and 
press RUN. 

Check that the mag- 
netic tape is ready- 
push RUN to retry. 

Check tape punch. 

Set switch register 
and push RUN. 



RTGEN ERROR MESSAGES 

Tlie following messages may be printed on the Hst device 
during execution of RTGEN: 

MESSAGES DURING INITIALIZATION AND INPUT 
PHASE 



ERR 01 



Meaning: Invalid response to initialization request. 
Action: Message is repeated. Enter valid reply. 



ERR 02 



Meaning: Checksum error on program input. 



Action: 



Computer halts; reposition tape to beginning of 
record and press RUN to reread. If input is 
from MT or DF, it is automatically backspaced 
when RUN is pressed unless bit 15 is set. 



Halt 

Code 


Cause 

Disc error status is in 
the A-Register. 


Recovery Action 

Check that the disc 
drive is ready— push 
RUN to retry. 


Meaning: 
Action: 








ERR 03 


)2011 


Record out ( 
Same as ER] 


Df sequence 
^02. 



102031 Same as above. Occurs 
during execution of 
disc-resident part of 
bootstrap. 



Check that the disc 
drive is ready- push 
RUN to retry. 



ERR 04 



The following halts can occur during the operation of 
RTGEN. 



Meaning 
Action: 



Illegal record type. 
Same as ERR 02. 



ERR 05 



102000 


System error 


Irrecoverable 


Meanin 


102001 


Magnetic tape not 


Check that the mag- 


Action: 




ready. 


netic tape is ready- 
push RUN to retry. 





g: Duplicate entry point. 

Revise program by re-labeling the entr" points 
(the current entry point replaces the prt.ious 
entry point). 
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ERR 06 



Not used 



ERR 07 



Meaning: Program name or entry point table overflow of 
available memory. 

Action: Irrecoverable error. Revise or delete programs. 



ERR 08 

name 



Meaning: Duplicate program name. 

Action: The current program replaces the previous pro- 
gram. 



MESSAGES DURING THE PARAMETER PHASE 



ERR 09 



Meaning: Parameter name error (no such program). 
Action: Enter valid parameter statement. 







ERR 10 


Meaning: 
Action: 


Parameter tj 
Same as ER] 


/pe error. 
R09. 






ERR 11 


Meaning: 
Action: 


Parameter p 
Same as ER 


riority error 
R09. 






ERR 12 


Meaning: 
Action: 


Execution ir 
Same as EK 


iterval error 
^09. 



GENERAL MESSAGES 



ERR 13 



Meaning: BG segment precedes BG main disc-resident 
program. 

Action: Irrecoverable. 



ERR 14 



Meaning: InvaUd background bounds or illegal response 
to CHANGE FWA SYS MEM? or to CHANGE 
BP LINKAGE? 

Action: Message is repeated. Enter valid reply. 



ERR 15 



Meaning: 



Type 6, 14, or 30 module illegally calling a 
module that is not type 0, 6, 14, or 30. 



Action: Revise the caUing module. 



ERR 16 



Meaning: 



Action: 



Base page linkage overflow into system commu- 
nication area. 

Diagnostic printed for each word required 
(communication area is used). Revise order of 
program loading or CHANGE BP LINKAGE 
answers to reduce linkage requirements. 



ERR 17 



Meaning: 



Action: 



Meaning: 



Action: 



Current disc address exceeds number of avail- 
able tracks. 

Irrecoverable error. 



ERR W 



Memory overflow (absolute code exceeds LWA 
memory). 

Diagnostic printed for each word required (ab- 
solute code is generated beyond LWA). Revise 
program or BG BOUNDARY answer. 



ERR 19 



Not used 



ERR 20 



Not used 



ERR 21 



Meaning: Module containing entry point $CIC not 
loaded. 

Action: Irrecoverable error. 
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Meaning: 



Action: 



ERR 22 

Read parity/decode disc error. A-Register bits 
7-14 show track number; bits 0-6 show sector 
number. 

After ten attempts to read or write the disc 
sector, the computer halts. To try ten more 
times, press RUN. 



ERR 23 



Meaning: Invalid FWA BP LINKAGE. 



Action: Message repeated; enter valid reply. 



MESSAGES DURING I/O TABLE ENTRY 



ERR 24 



Meaning: Invalid channel number. 
Action: Enter valid EQT statement. 



ERR 25 



Meaning: Invalid driver name or no driver entry points. 



Action: Same as ERR 24. 



ERR 26 



Meaning: 
Action: 

Meaning: 
Action: 

Meaning: 
Action: 



InvaUd or duphcate D, B, T operands. 
Same as ERR 24. 



ERR 27 



Invalid logical unit number. 
Enter valid DRT statement. 



ERR2J 



Invalid channel number. 
Enter valid INT statement. 



ERR 29 



Meaning: Channel number decreasing. 

Action: Same as ERR 28. 
6-48 







ERR 30 


Meaning: 
Action: 


Invalid mnemonic. 
Same as ERR 28. 






ERR 31 


Meaning: 
Action: 


Invalid EQT number. 
Same as ERR 28. 






ERR 32 


Meaning: 
Action: 


Invalid program name. 
Same as ERR 28. 






ERR 33 


Meaning: 
Action: 


Invalid entry point. 
Same as ERR 28. 






ERR 34 


Meaning: 
Action: 


Invalid absolute value. 
Same as ERR 28. 






ERR 35 



Meaning: Base page interrupt locations overflow into 
linkage area. 

Action: Re-start Disc Loading Phase at FWA BP LINK- 
AGE? request. 



ERR 36 



Meaning: Invalid number of characters in final operand. 
Action: Same as ERR 28. 

GENERAL MESSAGE 



ERR 37 

name 



Meaning: Invalid declaration of common in system or li- 
brary programs (name is the illegal program). 

Action: Revise the program. 
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ERR 38 



Meaning: 



Action: 



System area overflows scratch area. (This error 
sometimes possible when restarting disc loading 
phase; irrecoverable.) 

Check order of loading programs or move 
scratch boundary up. 



ERR 39 

name 



Meaning: 



System illegally referenced a type 6 program 
{name is the type 6 program). 



Action: Revise the program. 



ERR 40 



Meaning: First system track defective or first scratch 
track defective. 

Action: Redefine the track areas. 



ERR 41 



Meaning: More than 10 bad tracks on system, auxiliary 
and scratch discs combined. 

Action: Redefine track area. 



ERR 42 



Meaning: Absolute system area contains a bad track. 
Action: Redefine track area. 



ERR 43 



Meaning: Disc specifications do not conform to system 
disc. 

Action: Redefine track area or sectors per track 
answers. 



ERR 45 



Meaning: 
Action: 



Invahd partition size. 

Reenter partition description with valid decimal 
size, between 1 and 1024 pages. 



ERR 46 



Meaning: 
Action: 



Invalid partition type. 

Reenter partition description with vaUd type, 
BG or RT. 



ERR 47 



Meaning: InvaUd reservation parameter. 

Action: Reenter partition description. Fourth parame- 
ter must be "R" to reserve a partition. 



ERR 48 



Meaning: Invalid or unknown program name. 

Action: Reenter response with corrected name or enter 
/E to end thi^ sequence. 



ERR 49 



Meaning: InvaUd partition number. 

Action: Reenter response with corrected number or 
enter /E to end this sequence. 



ERR 44 



Meaning: InvaUd partition number entered. 

Action: Reenter partition description with vaUd decimal 
number, between 1 and maximum defined 
during initiaUzation. 



ERR 50 



Meaning: Program specified is too large for partition 
assigned. 

Action: Assign program to a larger partition or continue 
without assigning this program. 
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ERR 51 



ERR 53 



Meaning: Invalid page size. Either smaller than the pro- Meaning: 

gram size, or larger than maximum addressable 
partition size. 

Action: Reenter response with valid size or continue Action: 

without overriding this program's page 
requirements. 



The sum of all partition sizes does not equal the 
number of pages remaining after System Avail- 
able Memory. 

Redefine all partitions. 



ERR 52 



Meaning: Module being relocated references an SSGA 
entry point but does not have proper program 
type to allow SSGA access. 

Action: Restart generation from Parameter Phase and 
change the main program involved to a type 
allowing SSGA access or to a type 8 to delete 
it from the generation. 



ERR 54 



Meaning: A subroutine or segment has declared more 
common than the associated main program. 

Action: Recompile the main program declaring the 

maximum common needed by any segment or 
subroutine to be used. 
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APPENDIX A 

This appendix contains the following information: 

SYSTEM COMMUNICATION AREA 

Base page locations of area used for 
system communication. 

PROGRAM ID SEGMENT MAP 

Format of ID segments kept in system area 
for user programs. 



EQUIPMENT TABLE 

Format of Equipment Table entries for RTE 
devices. 



DEVICE REFERENCE TABLE 

Format of table relating logical units to devices 
in Equipment Table. 



DISC LAYOUT 

Allocation of disc space for RTE system. 



SYSTEM COMMUNICATION AREA 

A block of storage in base page, starting at octal location 
1647, contains the system communication area and is used 
by RTE-III to define request parameters, I/O tables, 
scheduling lists, operating parameters, memory bounds, etc. 
The Real-Time Assembler allows relocatable programs to 
reference this area by absolute addresses 1647-1777 octal. 
User programs can read information from this area, but 
cannot alter it because of the memory protect feature. 



Octal Location Contents 



SYSTEM TABLE DEFINITION 



Description 



01650 


EQTA 


01651 


EQT# 


01652 


DRT 


01653 


LUMAX 


01654 


INTBA 


01655 


INTLG 


01656 


TAT 



01647 XI Address of index 

register save area 
FWA of equipment table 
No. of EQT entries 
FWA of device reference 
word 1 table 

No. of logical units (in DRT) 
FWA of interrupt table "^ 
No. of interrupt table entries 
FWA of track assignment 
table 

01657 KEYWD FWA of keyword block 

I/O MODULE/DRIVER COMMUNICATION 

01660 EQTl \ Addresses 

01661 EQT2 of 

01662 EQT3 first 

01663 EQT4 11 -words 

01664 EQT5 I of 

01665 EQT6 / current 

01666 EQT7 EQT 

01667 EQT8 entry 

01670 EQT9 (see 01771 

01671 EQT 10 for last 

01672 EQTll / 4 words) 

01673 CHAN Current DMA channel No. 

01674 TBG I/O address of time-base card 

01675 SYSTY EQT entry address of system 

TTY 

SYSTEM REQUEST PROCESSOR/ EXEC COMMUNICA- 
TION 



01676 
01677 
01700 
01701 
01702 
01703 
01704 
01705 
01706 
01707 
01710 



RQCNT 

RQRTN 

RQPl ' 

RQP2 

RQP3 

RQP4 

RQP5 

RQP6 

RQP7 

RQP8 

RQP9 > 



No. of request parameters - 1 

Return point address 

Addresses of 

request 

parameters 

(set 

for 

maximum 

of 9 

parameters) 



A-1 



RTE-III 



Octal Location Contents 



Description 



UTILITY PARAMETERS 



ADDRESSES OF SYSTEM LISTS 



01711 


SKEDD 


'Schedule' lisi 


01756 


TATSD 


01713 


SUSP2 


'Wait suspend' list 


01757 


SECT2 


01714 
01715 


SUSP3 
SUSP4 


'Available: memory' list 
'Disc allocation' list 


01760 


SECT3 


01716 


SUSP5 


'Operator suspend' list 


r\ 1 '-t j^ 1 


r-\ n /^ r r» 



DEFINITION OF EXECUTING PROGRAM ID SEGMENT 

01717 XEQT ID segment addr. of current 

program 

01720 XLINK 'Linkage' 

01721 XTEMP 'Temporary' (5-words) 

01726 XPRIO 'Priority' word 

01727 XPENT 'Primary entry point' 

01730 XSUSP 'Point of suspension' 

01731 XA 'A-Register' at suspension 

01732 XB 'B-Register' at suspension 

01733 XEO 'E and overflow'register 

suspension 



SYSTEM MODULE COMMUNICATION FLAGS 

01734 OPATN Operator/keyboard attention 

nag 

01735 OPFLG Operator communication flag 

01736 SWAP RT disc resident swapping 

flag 

01737 DUMMY I/O address of dummy 

interface card 

01740 IDS DA Disc addr. of first ID segment 

01741 IDSDP Position within sector 



DEFINITION OF MEMORY ALLOCATION BASES 



FWA user base page link area 

LWA user base page link area 

FWA user base page link 

FWA of resident library area 

FWA of real-time common 

Length of real common 

FWA of real-time partition 

LWA+1 memory real-time 

partition 

FWA of background common 

Length of background 

common 

FWA of background partition 



01742 




BPAl 


01743 




BPA2 


01744 




BPA3 


01745 




LBORG 


01746 




RTORG 


01747 




RTCOM 


01750 


D 


RTDRA 


01751 


D 


AVMEM 


01752 




BGORG 


01753 




BGCOM 


01754 


D 


BGDRA 



01761 


DSCLB 


01762 


DSCLN 


01763 


DSCUT 


01764 


DSCUN 


01765 


LGOTK 



01755- TATLG Length of track assignment 

table 

# of tracks on system disc 

# sectors/track on LU 2 
(system) 

# sectors/track on LU 3 
(aux.) 
Disc addr of res lib entry pts 

# of res lib entry points 
Disc addr. of RTE Library 

# of RTE Library routines 
EGO: LU#, starting track, 

# of tracks (same format as 
ID seg word 28) 

LGOC Current LGO track/sector 

address (same format as ID 

seg word 27) 
SFCUN LS: LU# and disc address 

(same format as ID seg 

word 27) 
MPTFL Memory protect on/off flag 

(0/1) 

EQT12 \ Address of 

EQT13 I last 4 

EQT14 I words of 

EQT15 J current EQT 

memory protect fence 
address 
01777 BGLWA LWA memory background 

partition 

The letter D indicates the contents of the location are set 
dynamically by the dispatcher. 

PROGRAM ID SEGMENT 

Each user program has a 28 word ID segment located in the 
system area. The format of the ID segment is shown in 
Table A-1 . The address of each ID segment is located in the 
Keyword Table (see location 01657). The ID segment 
contains static and dynamic information defining the 
properties of a program. The static information is set during 
generation time or when a program is loaded on-line, and 
the dynamic information is maintained by the Executive. 

The number of ID segments contained in a system is set 
during generation time, and is directly related to the 
number of programs that can be in core at any given time. 
If all the ID segments are in use, no more programs can be 
added on-line. 

Short ID segments requiring nine words are used only for 
background program segments. One short ID segment is 
required for each program segment. If an on-line load is 
done and there are no blank short ID segments available, 
a regular 28 word one will be used. 



01766 
01767 

01770 

01771 
01772 
01773 
01774 

01775 D FENCE 
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WORD 



2-6 
7 



CONTENTS 



15 



11 



10 



X-REGISTER AT SUSPENSION (MEMORY RESIDENT PROGRAMS ONLY) 



Y-REGISTER AT SUSPENSION (MEMORY RESIDENT PROGRAMS ONLY) 

1 ^ 1 '■ + , — 



LIST LINKAGE 



5 WORD TEMPORARY AREA USED FOR SPECIAL FLAGS IN QUEUES (ETC) 

1 1 J 1 



PRIORITY 

- - f - -- 

PRIMARY ENTRY POINT 



10 



12 



• 13 



• 14 



15 



16 



17 



19 



20 



21 



13 



• 24 



25 



• 26 



27 



POINT OF SUSPENSION (XSUSP) 

1 1 



A REGISTER ATSUSPENSION (XA) 

- t- + 

B REGISTER AT SUSPENSION (XB) 



E/O REGISTERS AT SUSPENSION (XEO) 



NAME (FIRST AND SECOND CHARACTERS) 

1 1 



NAME (THIRD AND FOURTH CHARACTERS) 

1 1 



NAME (FIFTH CHARACATER) 



NA 



NP 



W 



TM 
R 



CL 
D 



AM 



SS 



TYPE 



STATUS 



TIME LIST LINKAGE WORD 

1 

RESOLUTION T 

1 1 



I 



MULTIPLE 



LOW ORDER 16 BITS OF EXECUTE TIME LESS 24 HRS. IN 10's MS 

1 1 -4 1 



HIGH ORDER 16 BITS OF EXECUTE TIME 



BA 



FW 



AT 



RM 



ff OF PAGES 



LOW MAIN ADDRESS 

1 



HI MAIN ADDRESS +1 



LOW BASE PAGE ADDRESS 

1 ^ 



HI BASE PAGE ADDRESS +1 



DISC ADDRESS (LU (15,) 



28 



SWAP DISC ADDRESS (LU ( 



RN 



FATHER ID-SEG. NUMBER 



PARTITION 



TRACK (14 7), SECTOR (6-0) 



5), TRACK (14-7), "TRACKS (6-0) 



PORTION OF 
IDSEGMENT 
NORMALLY USED 
} BY MEMORY RES- 
IDENT PROGRAMS; 
LINK ISSTILL TO 
WORD 1. 



• WORDS USED IN SHORT IDSEGMENT 

WHERE: 

» = These bits are reserved for future improve- 
ments. 

TM = Temporary load (copy of ID segment is not on 
the disc). 

CL = Core lock (program may not be swapped). 

AM = All memory (program uses all of its area). 

SS = Short segment (indicates a 9-word ID segment). 

NA = No abort (pass abort errors to the program 
instead). 

NP = No parameters allowed on reschedule. 

W = Wait bit (waiting for program whose ID seg- 
ment address is in word 2). 

A = Abort on next list entry for this program. 
O = Operator suspend on next schedule attempt. 
R = Resource save (save resources when setting 
dormant). 



D = Dormant bit (set dormant on next schedule 

attempt). 

T = Time list entry bit (program is in the time list). 

BA = Batch (program is running under batch). 

FW = Father is waiting (he scheduled with wait). 

AT = Attention bit (operator has requested atten- 

tion). 

RM = Re-entrant memory must be moved before 

dispatching program. 

RE = Re-entrant routine in control now. 

PW = Program wait (some program wants to schedule 

this one). 

RN = Resource number either owned or 

locked by this program. 

RP = Reserved partition— only for programs that 

request it. 

MPFI = Memory protect fence index. 
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THE EQUIPMENT TABLE 

The Equipment Table (EQT) has an entry for each I/O 
controller recognized by RTE-III (these entries are 
established by the user when the RTE-III System is 
generated). These 15 -word EQT entries reside in the 
system, and have format as shown in Table A-2. 







Table A-2. 


EQT Table Entries 




Word 


Contents 




15 


14 13 12 


11 109 


8 76 


543 


2 1 


1 


I/O Request List Pointer 


2 


Driver "Initiation" Section Address 


3 


Driver "Completion" Section Address 


4 


D 


B 


P 


S 


T 


Unit # 


Channel # 


5 


AV 


EQ TYPE CODE 


STATUS 


6 


CONWD (Current I/O Request Word) 


7 


Request Buffer Address 


8 


Request ButTcr Length 


9 


Temporary Storage tor Optional Parameter 


10 


Temporary Storage for Optional Parameter 


11 


Temporary Storage for Driver 


12 


Temporary Storage for Driver 


13 


Temporary Storage for Driver 


14 


Device Time-Out Reset Value 


15 


Device Time-Out Clock 



Where; 

1) =^ 1 if DMA required. 

B = 1 if automatic output buffering used. 

P = 1 if driver is to process power fail. 

S = 1 if driver is to process time-out. 

T= 1 if device timed out (system sets to zero 

before each 1/0 request). 

Unit = Last sub-channel addressed, 

Channel = I/O select code for the I/O controller (lower 
number if a multi-board interface). 

AV = I/O controller availability indicator: 

= available for use. 

1 = disabled (down). 

2 = busy (current-ly in operation). 

3 = waiting i\)r an available DMA channel 



STATUS = the actual physical status or simulated status at 
the end of each operation. For paper tape 
devices, two status conditions are simulated: 
Bit 5 = 1 means end-of-tape on input, or tape 
supply low on output. 

type of device. When this octal number is 
linked with "DVx ," it identifies the device's 
software driver routine as follows: 
paper tape devices (or system control devices), 
teleprinter (or system keyboard control device), 
photoreader. 
papej tape punch. 

console (or system keyboard control device), 
mini cartridge, 
devices. 

unit record devices, 
plotter, 
card reader, 
line printer, 
mark sense card reader, 
magnetic tape/mass storage devices. 
7900 moving head disc, 
moving head disc, 
instruments. 

user control word supplied in the I/O EXEC 
call (see Section III). 

DEVICE REFERENCE TABLE 

Logical unit numbers numbers from decimal 1 to 63 pro- 
vide logical addressing of the physical devices defined in 
the EQT and the subchannels within the physical d(jvices 
(if applicable). These numbers are maintained in the Device 
Reference Table (DRT), which is created by the generator, 
and can be modified by the LU operator request (see Figure 
A-1). Base page location 1652 contains the address of the 
DRT first word table. Base page location 1653 contains 

the number of LU entries (LUMAX). 

Word 1 

y 



EQ = 


TYPE 


CODE 


00 to 07 = 


00 = 


01 = 


02 = 


05 sub = 


05 sub 1 


05 sub 2 


10 to 17 = 


10 = 


11 = 


12 = 


15 = 


20 to 37 = 


31 = 


32=7905 


40 to 77 = 


CONWD = 



Subchannel No. 


LU Lock Flag 


EQT Nun-iber 


15 


14'13'12 


11 


10' 9 1 8 ' 7 ' 6 


5 ' 4 ' 3 1 2 ' 1 





F 


Downed I/O Request List Pointer | 



Word 2 



F (up/down flag) = if device is up 

1 if device is down 



Figure A-1. Device Reference Table 

The first DRT word contains the EQT entry number of the 
device assigned to the logical unit, and the subchannel 
number within the EQT entry. The second DRT v/ord 
contains the logical unit's status (up or down) and a 
pointer to any downed I/O requests. If the pointer is less 
than 64, it is the LU number off of which the downed I/O 
requests are queued. If several LU's point to the same 
device, the requests are queued off the lowest LU number 
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(the major LU). If the pointer is greater than 64, it points 
to the device's downed I/O request Hst. There are separate 
tables for words oile and two, with the word two table 
located in memory immediately following the word one 
table. The functions of logical units 1 through 6 are pre- 
defined in the RTE-III System as: 

1 — system console 

2 - reserved for system 

3 - - reserved for system 

4 - standard output unit' 

5 - standard input unit 

6 - standard list unit 

DISC LAYOUT OF RTE-III SYSTEM 

Figure A-2 diagrams the allocation of disc space by the 
system generator when it creates an RTE-III System. The 
bottom portion of the figure shows the difference between 
loader area in the moving head and fixed head system. 

TABLES 



DISC PROTECT 
BOUNDARY 



AVAILABLE DISC 
SPACE (For Swapping, scratch files) 

RELOCATABLE 

LIBRARY AND UTILITY 

PROGRAMS 



LIBRARY ENTRY POINTS 



BASE PAGE LINKAGES 



BACKGROUND DISC RESIDENT 



BACKGROUND RESIDENTS 



BASE PAGE LINKAGES 
REAL-TliVIE DISC RESIDENT 



COMMON AREAS 



REAL-TIME RESIDENTS 



RESIDENT LIBRARY 

SYSTEM I/O TABLES 

REAL-TIME EXECUTIVE 



SYSTEM COMM. AREA 
RESIDENT BASE PAGE LINKAGES 



SYSTEM COMM. AREA 

RESIDENT BASE PAGE 

LINKAGES 



RT SYSTEM LOADER 



Repeated for all 
, Background Disc 
Resident and Back- 
ground Segments 



Repeated for all 
" Real-Time Disc 
Residents 



TPRTE-23 
Figure A-2. Disc Space Allocation in RTE-III System 
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APPENDIX B 
REAL-TIME DISC USAGE 



This appendix covers the following subjects: 

Track Configuration 
Multiple CPU/7905 Operation 
Source Record Format 

TRACK CONFIGURATION 

The configuration of disc tracks is normally done through 
the interactive generation process described in Section VI. 
However, when more than one disc controller is needed, 
the generator dialogue cannot be used and a track map table 
must be defined in a user program. Because they differ, 
this process is described separately for the 7900 and 7905 
discs. 

For both the 7900 and 7905, when a program tries to access 
a track by a track number greater than the number of tracks 
assigned to a given subchannel, the driver sets bit 5 in the 
status word (end-of-disc) and exits with the transmission 
log set to the number of tracks assigned to the subchannel. 
To obtain this information, a program can request an im- 
possible track number once and thereafter stay within the 
bounds on the subchannel. 

If a parity error occurs during disc transfer, a special error 
message is printed (see'Appendix E). For peripheral disc 
transfers, a parity error causes the transmission log to be 
returned to the calling program as -1 . 



7900 EXTRA CONTROLLER TRACK CONFIGURATION 

The track map table used for a 7900 disc system must 
contain the following: 

• Number of sectors per logical track 

• First track number on subchannels through 7 

• Number of tracks on subchannels through 7 

The information needed to properly configure a disc is 
fully described in Section VI. The most necessary infor- 
mation is recapitulated here. 



The 7900 Disc Drive has a maximum of 203 tracks per 
platter. The two platters on each drive arc divided as follows: 

1 28 words per sector 

48 sectors per track 

203 tracks per platter 

The RTF 7900 Disc Driver treats a logical track as: 

64 words per sector 
96 sectors per track 

SUBCHANNELS 

The moving head driver for an HP 7900 disc system can 
have four drives chained to a single controller. There may 
be two platters per drive, and each disc platter is a sub- 
channel accessed through a logical unit number that is 
referenced back to the equipment table (EQT) entry 
number of the controller. Thus, the disc system can 
control a maximum of eight subchannels, numbered 
through 7. 

Subchannels are numbered so that even-numbered sub- 
channels are fixed platters and odd numbered sub- 
channels are removable platters. 

SECTORS 

READ DATA. The drivers divide each track into 64-word 
sectors. Whenever more than 64 words are transmitted, the 
READ request is fastest when begun on an even sector. 



WRITE DATA. WRITE requests starting on an odd sector 
or ending in an even sector require more time; thus, the 
fastest transfers are WRITE requests that start on an even 
sector and end in an odd sector. The system always organ- 
izes programs and swaps them out in such a way that trans- 
fers start on an even and end on an odd sector, thereby 
minimizing program load and swap times. The WRITE re- 
quest data can be checked for recoverability by setting bit 10 
in the control word (ICNWD). This check on all data written 
slows the WRITE process. 
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TRACKS 

Each subchannel may contain from to 203 tracks. 203 
tracks are the maximum available on the 7900 physical 
disc. The first track may be any track on the platter. 
Tracks available to the driver are numbered relative to the 
first track assigned to the system on each subchannel; 
thus, if the first available physical track on a subchannel 
is 10, access by the user to this track must specify logical 
track number 0. 



DEFINING 7900 TRACK MAP TABLE 

When an extra controller is used, tracks can only be 
mapped by defining a table in the user program as 
follows: 



ASMB,R,B,L 

NAM 
ENT 
$TB31 DEC 
DEC 
DEC 
END 



$TB31,0 

$TB31 

-n 

FT0,FT1,FT2,FT3,FT4,FT5,FT6,FT7 

NOO,N01 ,N02,N03,N04,N05,N06,N07 



where n is the number of 64-word sectors per track 

FTO through FT7 are the first track numbers for each 
subchannel through 7 

NOO through N07 are the number of tracks on sub- 
channels through 7 

Example: 

Assume a 7900 disc with two subchannels, and 1 . Place 
tracks through 100 on subchannel and tracks 20 through 
80 on subchannel 1 . 



ASMB,R,B,L 
NAM 
ENT 

$TB31 DEC 
DEC 
DEC 
END 



$TB31,0 

$TB31 

-96 96 sectors per track 

0,20,0,0,0,0,0,0 

101,61,0,0,0,0,0,0 



And for each subchannel, the following must be specified: 

• Cylinder number of track 

• Number of surfaces per cylinder 

• Head number of track 

• Unit number of disc drive 

• Number of tracks on subchannel 

To properly configure a track on the 7905, certain infor- 
mation is given here; a full description of track configura- 
tion can be found in Section VI. 

The HP 7905 Disc Drive provides three surfaces per disc 
drive. Each surface is divided as follows: 

128 words per sector 

48 sectors per track 

411 tracks per surface 

The RTE 7905 Disc Driver treats a logical track as: 

64 words per sector 
96 sectors per track 

SUBCHANNELS 

The HP 7905 disc system can control up to eight disc drives 
connected to one controller. Each disc drive consists of two 
platters of which one surface is reserved leaving three sur- 
faces to record data. Unlike the 7900, the 7905 subchannels 
are not directly related, one per platter, to the disc drive and 
the 7905 is not restricted to eight subchannels. 

Each subchannel is a contiguous group of tracks on a single 
drive. There may be more than one subchannel per drive, 
but subchannels cannot cross drive boundaries. The exact 
number of subchannels is specified by the user. There may 
be as many as 32 subchannels per drive. Subchannels are 
numbered sequenfially from zero; no numbers may be 
skipped. 

SECTORS 

The discussion of sectors for the 7900 is also true for the 

7905. 

TRACKS 



7905 EXTRA CONTROLLER TRACK CONFIGURATION 

The table used to map the 7905 contains the following 
information: 

• Number of sectors per track 

• Total number of subchannels on drive 



Each disc drive has 41 1 cylinders (or head positions) re- 
sulting in a maximum of 1,233 tracks (41 1 head posifions 
times the 3 disc surfaces). Theorefically, this number of 
tracks could all be assigned to one subchannel, however, 
there are program limitations. Peripheral disc subchannels 
used by the Batch-Spool Monitor must not have more than 
1024 tracks, excluding spares, per subchannel. On system 
or auxiliary discs (logical units 2 or 3), each subchannel is 
limited to 256 tracks excluding spares. 
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Head positions (cylinders) are numbered from through 
410, There is one head for each surface, numbered 0, 1, 2. 

SURFACE ORGANIZATION 

Subchannels may be on one, two, or three surfaces, one 
head per surface. It is best to alternate surfaces when more 
than one surface is used. This minimizes head movement. 
For example, if track is at cylinder (head position) 10 on 
head 0, then track 1 should be at cylinder 10 on head 1 and 
track 2 at cyHnder 1 1 on head 0. The implications of spUt- 
ing a subchannel between fixed and removable platters are 
discussed in Section VI under Disc Planning. 

UNIT NUMBER 

The unit number is a number associated with each 7905 
disc drive. It may be set by the user behind the front panel 
of the drive, and is always displayed on the front panel. 
There may be eight units, numbered through 7, 

DEFINING THE 7905 TRACK MAP TABLE 

When an extra controller is needed, tracks are mapped in a 
table defined as follows: 



ASMB,R,B,L 

NAME $TB32,0 
ENT $TB32 

$TB32 DEC 



SCO 



SCI 



SCn-1 



DEC 
DEC 

OCT 
DEC 



96 number of 64-word sectors must 
be 96 

-n n is the total number of subchannels 

X cylinder number of track for sub- 
channel (SCO) 

a a is defined below 

t t is the number of tracks this sub- 
channel 



repeat for next subchannel 



until all subchannels are defined 



Example: 

Define 10 HP 7905 subchannels using two surfaces of the 
removable disc cartridge. The number of tracks on each 
subchannel is 76 plus 4 spare tracks per subchannel. Each 
subchannel starts at head 0. Only the first three subchannel 
definitions are fully shown in the following code : 



,0 



ASMB,R,B,L 






NAM 


$TB32 




ENT 


$TB32 


$TB32 


DEC 


96 




DEC 


-10 


SCO 


DEC 







OCT 


20005 




DEC 


76 


SCI 


DEC 


40 




OCT 


20005 




DEC 


76 


SC2 


DEC 


80 




OCT 


20005 




DEC 


76 


SC3 


DEC 


120 



total of 10 subchannels 

first subchannel (subchannel 0) 

starts at cylinder 

two surfaces, head 0, unit 5 

76 tracks for subchannel 

Second subchannel starts at 

cylinder 40 (4 spare tracks) 



third subchannel starts at cylin- 
der 80 (4 spare tracks) 



continue for remaining sub- 
channels through SC9 



SC9 



DEC 
OCT 
DEC 
END 



360 

20005 

76 



END 



MULTIPLE CPU/7905 SYSTEM OPERATION 

In a multiple CPU/7905 System environment, the 7905 disc 
drivers and the controller prevent destructive interference 
during transfers of data to and from the disc. If a CPU is not 
to share access to the same physical disc addresses with any 
other CPU, this is adequate protection. 

If a file or set of files is to be shared by more than one CPU, 
a procedure is needed to prevent the following possible 
events: 



Where: 

a is defined as: 

bits 15 - 12 = number of surfaces per cylinder 
bits 11-8 = head number of track 
bits 3-0 = unit number of the disc 

Spare tracks can be specified by skipping tracks after each 
subchannel when constructing the table, A good rule of 
thumb is to have 1 1 spare tracks for every 400 tracks; this is 
the same as 11 spare tracks per surface. To skip tracks, set 
the cyUnder number of track for each subchannel to a 
number greater than the cylinder number of the last track 
of the next lower subchannel on that surface. 



a. CPU A reads a sector to update it. 

b. CPU B reads the same sector to update it. 

c. CPU A writes its updated sector back to the disc. 

d. CPU B writes its updated sector back to the disc, de- 
stroying the effect of CPU A access. 

To allow software to be written to effect multiple CPU/ 
7905 System operation without destructive interference, 
the HP 7905 driver (DVR32) services a lock/unlock func- 
tion call. This call can be issued from one CPU to lock the 
disc during an I/O operation or set of I/O operations. No 
other CPU can access the disc until an unlock function call 
is issued by the original CPU. 
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DVR32 LOCK/UNLOCK FUNCTION CALL 

The I/O Control request (see Section III) is used to hold a 
Resource Number (RN) and, subsequently, to release the 
RN. The RN must be allocated and set as a global RN prior 
to issuing the I/O Control request. For a description of Re- 
source Numbering, see Resource Management in Section III. 

The FORTRAN IV calHng sequence for an I/O Control 
request containing a lock/unlock function call is: 

IC0DE=3 

ICNWD=confro/ word 

IRNUM=resource number 

CALL EXEC(ICODE,ICNWD,IRNUM) 

ICNWD defines a one-word octal value containing control 
information. For DVR32, control word bits 12-6 contain a 
function code for the following control states: 



Function Code 
(bits 12-6) 

15 
00 



Meaning 

Lock 
Unlock 



IRNUM is specified only for funcfion code 15. IRNUM 
contains the RN to be cleared when the lock function call 
is executed. If a lock is currently in effect from another 
CPU, the calling program is suspended until the disc is avail- 
able. If the lock is obtained immediately, the I/O Control 
request completes immediately. If a lock is already in force 
by this disc controller, the request completes with the RN 
cleared. 

The lock/unlock function codes are provided to alleviate 
any CPU contention problem. If a CPU wishes to modify 
the same disc area as another CPU, the following code se- 
quence could be executed from both units to prevent their 
interfering with each other: 

IC0DE=12B Allocate and 

CALL RNRQ(ICODE,IRNUM,ISTAT) set global RN 

CALL EXEC(3,IDLU+ 1 5 OOB, IRNUM) -Issue lock call, 

function code 
= 15 



CALL RNRQ(5, IRNUM, 1ST AT) 



- Set/clear the 
RN 

Lock is 
granted by 
this point 



CALLEXEC(1,IDLU, ....) 

CALL EXEC(2,IDLU, . . . .) 
CALLEXEC(3,IDLU) 



Next, read the 
disc and 
modify data 

Then, write it 
back. 

Now, issue 
unlock call, 
function code 
= 



To use the lock/unlock function, each CPU operating sys- 
tem must support it. 

The sequence described previously for CPU A and ("PU B 
using the lock/ unlock function would now be: 

ai . CPU A requests a lock from the driver and it is 
granted (no other CPU has a lock in force). 

a2 . CPU A reads a sector to update it. 

bi . CPU B requests a lock from its driver. Because CPU 
A has a lock, CPU B must wait. 

Ci . CPU A writes its updated sector back to the disc. 

C2 . CPU A releases its lock. 

b2 . CPU B disc driver gets an interrupt from the disc 
controller informing it that the lock is now available 
and completes the lock requested by B at step bi . 

b3 . CPU B reads the same sector to update it. 

di . CPU B writes its updated sector back to the disc. 
The sector now has both updates. 

do . CPU B releases its lock. 



SOURCE RECORD FORMATS 

The source format used for the disc records by the system 
programs Editor, Assembler, ALGOL, FORTRAN and 
FORTRAN IV, is given in Table B-1. All records are 
packed ignoring sector boundaries. Binary records are 
packed directly onto the disc. After an END record, a 
zero word is written and the rest of the sector is skipped. 
If tliis zero word is the first word of the sector, it is not 
written. Binary files are always contiguous so a code 
word is not required. 
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Table B-1. Source Format 



15 



8 7 



Word 1 



L 


ZERO 



Where L is the record length in words excluding 
Word 1 



Word 2 



CHARl 


CHAR2 



If Word 1 =0 then end of TAPE 
If Word 1 = -1 then end of FILE 

Odd characters are padded with blanks to make a full word. The last 
word on any given track in a multi-track file is a code word that points 
to the next track in the file. 

Code Word Format 

15' 7 



LU# 


TRACK 



Where LU# is either 2 (system) or 3 (auxiliary) depending on which 
platter the track is on. 
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APPENDIX C 

SAMPLE RTE-III 

GENERATION 



NOTE 



The two completed worksheets included 
in this Appendix are samples of an HP 
7905 Disc Configuration. The generator 
listing is from an HP 7900 Disc Configuration 
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Table C-1 . Completed Worksheet Giving Suggested 7905 Disc Configuration 



STEP 1 FILL IN UNIT NUMBER: 





CYLINDER 


HEAD 






l_ 


HEAD 1 - 





CYLINDER 410 



TIMING 
HEAD 



HEAD 2 



O 




UNIT# 



4- 



Au?(ILiAtcy g,^ 



STEP 2 j TRACKS SHOWN END-TO-END ON THREE SURFACES-CIRCLE SUBCHANNELS: 

CYLINDER 40 80 120 150 200 240 280 320 360 400 410 



HEAD 
HEAD 1 
HEAD 2 



STEP 3 



::(: 

J 



$rr|/M) 



Sc^ge^A.U^ii^ < r31<>7|gK 



t 






SfM 



2^ 



TRANSLATE STEP 2 TO NUMBERS: 




•7VV-' • 'lA. HtMUVABLE 



REMOVABLE 



FIXED 



^^y 



SUBCHANNEL 


^ 


\ 


a. 








NUMBER OF 
TRACKS 


»sc 


m 


f'f'^ 








STARTING 
CYLINDER 


'f 


^69 


P 








STARTING 
HEAD 


X 


3l 











NUMBER OF 
SURFACES 


1 


1 


a 








NUMBER OF 
SPARES 


s- 


9 


in 








SYSTEM ? 


^ 






' 






AUXILIARY 




>^ 










SCRATCH ? 
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Table C-2. Completed Worksheet Giving Suggested 7905 Disc Configuration 



STEP 1 



FILL IN UNIT NUMBER: 



STEP 2 



CYLINDER 



HEAD 



HEAD 1 



TIMING 
HEAD 



HEAD 2 



n 



JZl 



CYLINDER 410 




UNIT#- 






TRACKS SHOWN END-TO-END ON THREE SURFACES-CIRCLE SUBCHANNELS: 

CYLINDER 40 80 120 150 200 240 280 320 360 400 410 




Sl^SCHAA'^C'C 










REMOVABLE 



FIXED 



STEPS 



TRANSLATE STEP 2 TO NUMBERS; 



SUBCHANNEL 


P 


1 


X 








NUMBER OF 
TRACKS 


?56 


5*va 


m^(f> 








STARTING 
CYLINDER 


^ 


/^^ 


^ 








STARTING 
HEAD 


P 





a 








NUMBER OF 
SURFACES 


a 


^ 


; 








NUMBER OF 
SPARES 


8- 


IL 


// 








SYSTEM 7 


t^ 












AUXILIARY 














SCRATCH ? 
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HH DISC 


CHNL7 






21 








# TRK8, 


FIRST TRK 


ON 


SUBCHNLI 


0? 








2(93,0 








J? 








29)3,0 








2? 








203,0 








37 








203,0 








4? 








203,0 








57 








203,0 








e? 








203,0 








77 








203,0 








# 128 WORD SECTORS/TRACK? 


48 








SYSTEM 


SUBCHNL7 















SCRATCH 


SU8CHN17 
















AUX DISC (YES OR NO OR n TRKS)? 
YES 



AUX 
I 


DISC SU8CHNL7 


START SCRATCH? 


TBG 
13 


CHNL7 


PRIV, INT. CARD ADDR? 




PRIV, DRIVERS ACCESS COMMON? 
NO 

RT CORE LOCK? 
YE 

B6 CORE LOCK? 
YE 

SWAP DELAY? 
50 
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MEM SIZE? 
64 

PRGM INPT7 
MT 

LI8R INPT? 
PT 

PRAM INPT? 
TV 

INITIALIZE SUBCHNLJ 

0? 
NO 

2? 
NO 

37 
NO 

47 
NO 

57 
NO 

6? 
NO 

77 
NO 

PUNCH BOOT? 
YE 

PUNCH BOOT? 
NO 



HALT 77 m SET SWR & PRESS RUN 

*EOT 

HALT 77 m SET SWR & PRESS RUN 

NO UNDEP EXTS 
HALT 77 - SET SWR & PRESS RUN 

PARAMETERS 

O.RTR.1,1 

WHZAT,2,l 

ASMB,3,95 

XREF,3,96 

E0ITR,3,5l?l 

/E 

CHANGE ENTS? 
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*EAU MACRO'S 
.MPY#RPil00200 

.OLD#RPr 104200 
.DST,RP, 10^^400 
*HFP MACRO'S 
,FA0,RP, 105000 

.FSB,RP, 105020 
,FMP,RP, 105040 
.FDV,RP, 105060 

IFIX,RPm05100 
FLOAT, RP, 105120 
*FFP MACRO'S 
* DBLE.RP, 10^^01 
SNGL,RP, 105202 
.XMPY, HP. 105203 
.XDIViRP. 105204 
.DFER,RP, 105205 
.XADD,RP. 105213 
.XSUB, HP. 105214 



* .GOTO/RP. 105221 

* ,.MAP,RP,105222 

* .ENTR,RP, 105223 

* ,ENTP,RP, 105224 
*2lMX EXTENSION MACRO'S 

* .MVW,RPf 105777 
*FFP MX 

.PWR2,RP, U'l5225 
.FLUN,RP,l,]5226 
.PACKfRP, U^5230 
,XFER,RP,UJ5220 
.XPAK,RP, ii;15206 
.XCOM,RP, I,i52l5 
/.OCM,RP, 105216 
DOINT,RP, 105217 
XADD ,RPfl05207 
XSUB ,RP,fk^5210 
XMPY rRP#l052n 
XDIV ,RP, 1^5212 

/E 



** OF BLANK 10 SEGMENTS? 
10 

# OF BLANK BG SEG, ID SEGMENTS? 
25 

MAX NUMBER OF PARTITIONS? 

FWA BP LINKAGE? 
l(?»0 



SYSTEM 

SCHEO(«099)P)203S 05305 
*$LIST 02077 



92060-16020 REV, A 750505 



*$M£SS 


02435 


•$CVT3 


04357 


*$CVTl 


04423 


*$ABRT 


04515 


*$TYPE 


04427 


*$MPT1 


04557 


*$MPT2 


04732 


*$MPT3 


04745 


*$MPT4 


05035 


*$MPT5 


05055 


*$MPT8 


05074 


*$PARS 


02545 


*»STRT 


03430 


#S8C03 


05013 


♦SINER 


04071 


*$MPT7 


06126 
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BP 



*SA8TM 
*$MPT8 
♦SIONO 
*SWORK 
*SWATR 
*SIDSM 
*SMPSA 
LINKAGE 



02500 
052S2 
05113 
02045 
04722 
04143 
03566 
01640 



RTIOC(0099305444 11602 92060«16016 REV, A 750505 



BP 



*SCIC 

*S8YMG 

*SIORQ 

*SIOUP 

*$XOON 

*SETEQ 

*S1RT 

*SXCIC 

*$DEVT 

*|GTIO 

♦SUPIO 

*SCVEQ 

*$YCIC 

♦SBULO 

*SBLUP 

*SDVM 

*SRSM 

*$IOCL 

*$LUPR 

♦SEQST 

*$CHTO 

LINKAGE 



05444 
07620 
10721 
05657 
10707 
10656 
11033 
05575 
05460 
10577 
06676 
10710 
11011 
05461 
01637 
01640 
07232 
07411 
11072 
11207 
11352 
11440 
01531 



EXECDf0099) 11646 13610 92060-16018 KEV.A 75(5505 



*EX£C 

*$ERMG 

*SRQST 

*«OTRL 

*$LIBR 

*$LIBX 

♦SOREQ 

*SDREt 

*$SORL 
*SSOSK 
*$ERAB 
*$PVCN 

*$Reio 

*SCREL 
*SRSR£ 
ASABRE 
*$PWR5 
*$MVBF 
BP LINKAGE 



11646 
13443 
11650 
13200 
12062 
12640 
13232 
13316 
13205 
13334 
13173 
12202 
12356 
13074 
12440 
12544 
11735 
12437 
01476 



$AUC (0099)13624 
*$AUC 13624 
*SRTN 13725 

BP LINKAGE 01465 



14051 92060-16017 REV, A 750505 



RTIME(;3PI99)14054 14625 92060-16014 750305 
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*STAOO 


14525 


*SCtCK 


14054 


*STREM 


14547 


♦ITIME 


14256 


<r$TIMV 


14324 


•SETTM 


14472 


*STIMR 


14420 


*10NTM 


14371 


*$TMRQ 


14575 


*$SCIK 


14275 


*$BATM 


14253 


BP LINKAGE 


01452 


OISPMC0099)14647 17515 


*SRENT 


15216 


*SBRED 


17322 


*$Z2ZZ 


17403 


ASXEQ 


14724 


*$Mt<Mp 


15144 


*SENDS 


15145 


♦SMATA 


15146 


*$MPFT 


15147 


*$BGFR 


15150 


*$RTFR 


15152 


*$AUOM 


16254 


**dmal 


16257 


*$SMAP 


15320 


*$PRCN 


16303 


*SEMRP 


15111 


♦SUPSA 


15112 


*SXDMP 


15413 


BP LINKAGE 


01434 


$TRRN(0099)17632 17775 


*$TRRN 


17632 


*SCGRN 


17676 


*SULLU 


17720 


BP LINKAGE 


01432 



92060-16013 REV, A 750505 



92060-16019 750326 



$ASCM(0099) 17776 20055 92060-16015 741120 

*»OPER 20026 

*$ERIN 20046 

♦SNOPG 20036 

*$ILST 17776 

*$NOLG 20007 

*SLGBS 20017 

BP LINKAGE 01424 

$YSLBf0099)20056 20055 92001-16005 REV.B 741120 
BP LINKAGE 01424 

$BAL8C0099)20056 20055 92002-16006 REV,C 750312 
BP LINKAGE 01424 

SSPOLC0099320056 20055 92002-16001 REV.C 750416 
BP LINKAGE 01424 

DVS43(0099)20126 22430 92060-16009 REV, A 750505 
*IS43 20126 
*CS43 21576 
*$MPIO 20434 
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*N,8E0 21735 
BP LINKAGE 01422 

OVP43C0099)22431 
*SPOWR 22431 
•IP43 231S7 
*CP43 23060 

BP LINKAGE 01416 



23211 92060-16001 REV, A 750505 



DVR00C0099)23241 24320 



*1.00 


23241 


*C,00 


23610 


*I.0l 


23241 


• C.01 


23610 


*1.02 


23241 


*C,02 


23610 


BP LINKAGE 


01416 


OVRll (0099524342 25471 


*C.ll 


25124 


*I.ll 


24342 


BP LINKAGE 


01416 



OVR12(0099)25476 26025 

*I,12 25476 

*C.12 25636 
BP LINKAGE 01404 

DVR23(0099)26026 26671 

*I,23 26026 

♦C,23 26643 
BP LINKAGE 01404 

DVR31C0099)26705 30075 

♦1,31 27552 

*C,31 27116 
BP LINKAGE 01404 



92202-16001 REV, A 



OVR62(0099)30101 31275 02313-16001 REV, A 750505 

*I,62 30101 

*C,62 30377 
BP LINKAGE 01401 



DVR63(0099331322 33266 

•1,63 31346 

*C,63 32771 
BP LINKAGE 01377 



09611-16005 REV, A 750401 



DVA13(0099)33304 33452 91200-16001 REV, A 740325 

*IA13 33304 

*CA13 33432 
BP LINKAGE 01377 

F4O,C(0099)33453 33452 
BP LINKAGE 01377 

F2F, 9(0099333453 33452 
BP LINKAGE 01377 



*# OF I/O CLASSES? 
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Sample RTE-III Generation 



16 

*# OF UU MAPPINGS? 
8 

**t OF RESOURCE NUMBERS? 
32 

BUFFER LIMITS CLOW, HIGH)? 
1001400 

* EQUIPMENT TABLE ENTRY 

EOT 01? 
21,DVR3l,0 

EOT 02? 
15,OVR00,B,T»32767 

EOT 03? 
40,DVA13,D 

EOT 04? 
17,DVR02,B,T»32767 

EOT 05? 
16,DVR01,Tp32767 

EOT 06? 
20,DVR12,B,T»32767 

EOT 07? 
25,OVR00,B,T«32767 

EOT 08? 
23,0VR23,D,B,T«32767 

EOT 09? 
26,DVR62 

EOT 10? 
27,DVR63 

EOT 11? 
14,DVRU,D 

EOT 12? 
30,DVR00,B,Ti32767 

EOT 13? 

31,DVR00,B,Tf32767 

EOT 14? 

32,OVR00,B,Ti32767 

EOT 15? 
33,DVR00,B,T»32767 

EOT 16? 
34,DVR00,B,T»32767 
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RTE-III 



EQT 17? 

35,DVR00,B,T»32767 

EOT 187 
3e,DVR00,B,TP327e7 

EOT 197 

37,DVR00,B,T»32767 

EOT 207 
72,DV843,)(»18 

EOT 217 
73rDVS43,X«16 

EOT 227 

74,DVS43,X«18 

EOT 237 

75,0VS43,Xil8 

EOT 247 
76,DVS43,X»18 

EOT 257 

77,DVS43,X«18 

EOT 267 
4,UVP43 

EOT 277 
/E 



* DEVICE REFERENCE TABLE 

* SYSTEM CONSOLE 

* SYSTEM DISC 

* AUXILIARY DISC 

* PAPER TAPE PUNCH 

* PHOTOREADER 

* LINEPRINTER 

* TERMINAL 

* MAG TAPE, UNIT 



1 ■ EOT $t7 

2,0 

2 • EQT HI 

li0 

3 » EQT «7 
1*1 

4 » EQT <*? 
4,4 

5 « EQT «? 



6 » EQT m 



7 ■ EOT «? 



8 « EQT HI 
6,0 



9 » EQT til 
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8,1 

10 » EOT ni 
8,2 

11 « EQT ni 
8,3 

12 « EQT #? 
11 

13 ■ EOT ni 

14 ■ EQT Ht 
1,2 

15 » EQT Ul 
1,3 

16 • EOT «7 
1,4 

17 « EOT «7 
1,5 

18 « EQT «7 
1.6 

19 » EQT «? 
1,7 

20 8 EQT *<? 
1? 

21 « EQT «? 

13 

22 « EQT «? 
14 

23 ■ EQT Wi 
1*5 

24 s EQT *<7 
16 

25 • EQT HI 
17 

26 » EQT «? 
18 

27 « EQT «? 
19 

28 • EQT «? 


29 « EQT Ml 

PI 



* MAG TAPE, UNIT I 

* MAG TAPE, UNIT 2 

* MAG TAPE, UNIT 3 

* CARD READER 

* BIT BUCKET 

* PERIPHERAL DISC 

* PERIPHERAL DISC 

* PERIPHERAL DISC 

* PERIPHERAL DISC 

* PERIPHERAL DISC 

* PERIPHERAL DISC 

* TERMINAL 

* TERMINAL 

* TERMINAL 

* TERMINAL 

* TERMINAL 

* TERMINAL 

* TERMINAL 

* TERMINAL 
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3P) ■ EQT «1 
9 

31 » EQT «7 
10 

32 i EQT #7 
3 

33 ■ EQT *7 


34 ■ EQT l<7 

35 ■ EQT *<7 



* H,P, 23139 SUBSYSTEM 



• H.P, 6940 SUBSYSTEM 



* H,P, 91200 TV INTFC 



36 




EQT 


HI 











37 




EQT 


Ul 











38 




EQT 


HI 











39 




EQT 


HI 











40 




EQT 


HI 











41 




EQT 


HI 











42 




EOT 


HI 











43 




EQT 


HI 


'/^ 








44 




EOT 


HI 











45 




EQT 


HI 











46 




EQT 


HI 











47 




EQT 


HI 











48 




EQT 


HI 











49 




EQT 


m 
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5PI • EOT HI 













51 • EOT #? 






2PI 


• SPOOL 


LU 


52 i EQT HI 






21 


* SPOOL 


LU 


53 " EQT tt7 






22 


* SPOOL 


LU 


54 » EQT ^7 






23 


* SPOOL 


LU 


55 • EOT #? 






24 


* SPOOL 


LU 


56 • EOT «? 






25 


* SPOOL 


LU 


57 « EQT «? 






26 


* POWER 


FAIL 


58 « EQT Ml 






/F 






* INTERRUPT TABLE 




4,eNT,$P0WR 






14, EQT, 11 






15,PRG,PRMPT 






16, EQT, 5 






17, EQT, 4 






20, EQT, 6 






21, EQT, 1 






22, EOT,! 






23, EQT, 8 






24, EQT, 8 






25,PRG,PRMPT 






26, EQT, 9 






27, EQT, 10 






3?l,PRG,PRMPT 






31,PRG,PRMPT 






32,PRG,PRMPT 






33,PRG,PRMPT 






34,PRG,PRMPT 






35,PRG,PRMPT 






36,PRG,PRMPT 






37,PRG,PRMPT 






40, EQT, 3 






72, EQT, 20 






73, EOT, 21 






74, EQT, 22 






75, EQT, 23 






76, EQT, 24 






77, EQT, 25 






/E 







BP LINKAGE 01371 
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UIBRARY 

EQUU 

,ENTR 

PRTN 

UURQ 

SALRN 



40050 
40126 
4021(5 
40321 
40646 



40125 
40215 
40920 
40645 
40753 



92001-16005 741120 



92001<«16005 
92001*16005 
92001**16005 



741120 
741120 
741106 



SUBSYSTEM GLOBAL MODULES 

SP.CL )40754 40754 92060P.16034 REV, A 750505 



RT COMMON 00000 

CHANGE RT COMMON ? 
200 

RT COM 40755 



BG COMMON 00000 

CHANGE 9G COMMON ? 
200 

BG COM 41265 



LWA BG COMMON 41574 

ALIGN AT NEXT PAGE? 

YES 

LWA BG COMMON 41777 

MEMORY RESIDENTS 

PRMPT(0010)42000 42110 92001-16003 REV.B 741216 

R$PN$C0010)42111 42257 92001-16003 REV.B 741002 
MESSS 42260 42352 92001-16005 741120 

D,RTRC000n42353 44271 92002-16007 750102 
P.PAS 44272 44320 92002-16006 740801 

EXTNDC0010)44321 44505 92060-16010 REV, A 750505 
RMPAR 44506 44530 
GETAO 44531 44546 

SPOUT(0010)44547 45425 92060-16011 REV, A 750505 
.DRCT 45426 45434 92001-16005 741120 



RT DISC RESIDENTS 

SMP (0030)42002 45122 
RNRQ 45123 45350 
,DRCT 45351 45357 



92060-16007 REV, A 750505 
92001-16005 741120 
92001-16005 741120 



OPEN 45360 45545 92002-16006 741205 

READF 45546 46273 92002-16006 740801 

REIO 46274 46376 92001-16005 741120 

CLOSE 46377 46505 92002-16006 7408PI1 
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POST 


46S06 


46534 


SOPEN 


4653S 


46743 


P.PAS 


46744 


46772 


HWSUd 


46773 


47244 


RWNDS 


47245 


47355 


R/W$ 


47356 


47511 


.itFER 


47512 


47555 


RMPAR 


47556 


47600 


GETAO 


47601 


47616 


JOB (003P!)42002 


43405 


RMRQ 


43406 


43633 


.DRCT 


43634 


43642 


REIO 


43643 


43745 


OPEN 


43746 


44133 


READF 


44134 


44661 


CLOSE 


44662 


44770 


POST 


44771 


45017 


SOPEN 


45020 


45226 


P.PAS 


45227 


45255 


RWSUB 


45256 


45527 


RWNDS 


45530 


45640 


R/W« 


45641 


45774 


,XFER 


45775 


46040 


RMPAR 


46041 


46063 


GETAO 


46064 


46101 


WHZATC0B0l)42PI02 


43700 


TMVAU 


43701 


43720 


AUTOR(0(?i0n42Pt02 


42407 


TMVAL 


42410 


42427 


FMTIO 


42430 


43660 


FRMTR 


43661 


46420 


081.E 


46421 


46455 


SNGL 


46456 


46523 


.XPAK 


46524 


46720 


,XCOM 


46721 


46771 


,XFER 


46772 


47035 


CLRIO 


47036 


47040 


,FUUN 


47041 


47061 


• PACK 


47062 


47175 


lAND 


47176 


47205 


PAUSE 


47206 


47351 


,ZRLB 


47352 


47412 


,OPSY 


47413 


47452 



92002*16006 740801 
92002-16006 740801 

92002-16006 740801 
92002-16006 740801 
92002tl6006 740801 
92002-16006 740801 



92002-»l6005 REV.C 750128 
92001-16005 741120 
92001-16005 741120 
92001-16005 741120 
92002-16006 741205 
92002-16006 740801 
92002-16006 740801 
92002-16006 740801 
92002-16006 740801 
92002-16006 740801 
92002-16006 740601 
92002-16006 740801 
92002-16006 740801 



WHZAT FOR RTE-III 75021 
92001-16005 741120 



92001-16005 741120 



8G DISC RESIDENTS 

FMGR (0090)42002 42754 92002-16008 REV.C 750312 



FM.CM 


42755 


44803 








.DRCT 


44604 


44612 


92001'" 


• 16005 


741120 


IFBRK 


44613 


44634 


92001- 


'16005 


741120 


OPEN 


44635 


45022 


92002-" 


•16006 


741205 


CLOSE 


45023 


45131 


92002- 


•16006 


740801 


SOPEN 


45132 


45340 


92002-16006 


74080 


RMNDS 


45341 


45451 


92002-16006 


740801 


R/WS 


45452 


45605 


92002-16006 


740801 


RMPAR 


45606 


45630 
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6ETAD 


45631 


45646 








FMGR0C0099)45647 


45654 


92002- 


•16008 


740801 


PK,, 


45655 


47272 








COR, A 


47273 


47306 


92001" 


•16005 


741120 


CR.. 


47307 


50412 








REAOF 


50413 


51140 


92002" 


'16006 


740801 


REIO 


51141 


51243 


92001" 


'16005 


741120 


RWNDF 


51244 


51325 


92002<* 


•16006 


740801 


NAM,, 


51326 


51422 


92002- 


'16006 


740801 


P,PAS 


51423 


51451 


92002« 


'16006 


740801 


RWSUB 


51452 


51723 


92002- 


•16006 


740801 


LOCK, 


51724 


51773 








FM.UT 


51774 


53116 








CREA, 


53117 


53170 








GREAT 


53171 


53446 


92002P 


• 16006 


741022 


,XFER 


53447 


53512 








FMGRlC0099)45647 


45762 


92302- 


• 16008 


741223 


.PARS 


45763 


47004 








C.TAB 


47005 


47135 


92002- 


• 16008 


74(«8C?fl 


CA,, 


47136 


47330 


92002- 


•16008 


741119 


REA.C 


47331 


47413 








EE,, 


47414 


47455 








TR,. 


47456 


47677 








MR.. 


47700 


50034 








SE,. 


50035 


50221 








IF,, 


50222 


50432 








AB,, 


50433 


50625 








DP., 


50626 


50665 








INPRS 


50666 


50762 


92001" 


-16005 


741119 


REAOF 


50763 


51510 


92002" 


•16006 


740801 


REIO 


51511 


51613 


92001' 


-16005 


741120 


POSNT 


51614 


52050 


92002- 


-16006 


740801 


P. PAS 


52051 


52077 


92002- 


»16006 


740801 


RWSUB 


52100 


52351 


92002- 


•16006 


740801 


WRLG 


52352 


52367 


92002- 


•16006 


740801 


CK.SM 


52370 


52503 








,XFER 


52504 


52547 








XWRIT 


52550 


53250 








,OPSY 


53251 


53310 








FMGR2C0PI99)45647 


45660 


92002-16008 


740801 


IN, IT 


45661 


46606 








IN,, 


46607 


50460 








MC,, 


50461 


5077PI 








RC,. 


50771 


51156 








PH.. 


51157 


51401 








PURGE 


51402 


51500 


92002-16006 


740801 


NAM,, 


51501 


51575 


92002-16006 


740801 


J, PUT 


51576 


51622 


92002-16006 


740801 


IPUT 


51623 


51643 


92002-16006 


74080 


FID. 


51644 


51763 








MSC, 


51764 


52020 








LOCK, 


52021 


52070 








FM.UT 


52071 


53213 








CNT, 


53214 


53434 








FCONT 


53435 


53526 


92002' 


•16006 


740801 


.XFER 


53527 


53572 









FMbR3C0Pl99545647 45654 92002-16008 740801 
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UI,, 45655 47314 

OL,, 47315 50534 

REAOF 50535 51862 92002^16006 740801 

REIO 51263 51365 92001-16005 741120 

lOCF 51366 51553 92002-16006 740801 

P.PAS 51554 51602 92002-16006 740801 

RWSUB 51603 52054 92002-16006 740801 

MSC, 52055 52111 

FM.UT 52112 53234 

.XFER 53235 53300 

FMGR4C0099)45647 45663 92002-16008 740801 

ST.DU 45664 47120 

CO., 47121 47623 

F,UTM 47624 47772 

OPMES 47773 50173 

CREAT 50174 50451 92002-16006 741022 

READF 50452 51177 92002-16006 740801 

REIO 51200 51302 92001-16005 741120 

RWNDF 51303 51364 92002-16006 740801 

LOCF 51365 51552 92002-16006 740801 

NAM,, 51553 51647 92002-16006 740801 

P.PAS 51650 51676 92002-16006 740801 

RWSUB 51677 52150 92002-16006 740801 

FM.UT 52151 53273 

CREA, 53274 53345 

CK.SM 53346 53461 

,yFER 53462 53525 

FMGR5C0099)45647 45656 92002-16008 740801 

??,, 45657 47772 92002-16008 740801 

RV,, 47773 50433 

RP., 50434 51575 

Tt,. 51576 51615 

READF 51616 52343 92002-16006 740801 

REIO 52344 52446 92001-16003 741120 

LOCF 52447 52634 92002-16006 740801 

P.PAS 52635 52663 92002-16006 740801 

RWSUB 52664 53135 92002-16006 740801 

J, PUT 53136 53162 92002-16006 740801 

IPUT 53163 53203 92002-16006 740801 

ID, A 53204 53273 

BUMP, 53274 53332 92002-16006 741025 

SET.T 53333 53361 92002-16006 740801 

TL, 53362 53411 92002-16006 741025 

ST.TM 53412 53446 92002-16006 741223 

,XFER 53447 53512 

FMGR6C0099)45647 45657 92002-16008 740801 

CN., 45660 45720 

JO,, 45721 47016 

RNRQ 47017 47244 92001-16005 741120 

KCVT 47245 47257 92001-16005 741120 

EO,, 47260 50103 

MESSS 50104 50176 92001-16005 741120 

OF,, 50177 50272 

LR,, 50273 50367 

NAMF 50370 50541 92002-16006 740801 

READF 50542 51267 92002-16006 740801 

REIO 51270 51372 92001-16005 741120 

POST 51373 51421 92002-16006 740801 
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NAM,, 31422 51516 92002*16006 740801 

P.PAS 51517 51545 92002-16006 740801 

RWSUB 51546 52017 92002-16006 740801 

SPOPN 52020 52070 92002-16006 741025 

SET.T 52071 52117 92002-16006 740801 

ST.TM 52120 52154 92002-16006 741223 

B.FUG 52155 52223 92002-16006 74U18 

LULU, 52224 52317 92002-16006 740801 

RANGE 52320 52343 92002-16006 740801 

ONOFF 52344 52707 92002-16006 750128 

EX.TM 52710 53076 92002-16006 741008 

IPUT 53077 53117 92002-16006 740801 

FREE, 53120 53167 92002-16006 740801 

LU.CL 53170 53231 92002-16006 740801 

AVAIL 53232 53324 92002-16006 741231 

,XFER 53325 53370 

FMGR7C0099)45647 45656 92002-16008 740801 

CL,. 45657 46140 

NX,JB 46141 47006 

RNRQ 47007 47234 92001-16005 74U20 

LU,, 47235 50307 

KCVT 50310 50322 92001-16005 741120 

CS,. 50323 50520 

READf 50521 51246 92002-16006 740801 

REIO 51247 51351 92001-16005 741120 

FSTAT 51352 51376 92002-16006 740801 

POST 51377 51425 92002-16006 740801 

P,PAS 51426 51454 92002-16006 740801 

RMSUB 51455 51726 92002-16006 740801 

SPOPN 51727 51777 92002-16006 741025 

B.FL6 52900 5204$ 92002-16006 741118 

LULU, 52047 32142 92002-16006 740801 

RANGE 52143 52166 92002-16006 740801 

AVAIL 58167 52261 92002-16006 741231 

,XFER 52262 52325 

FHGR8(0099}45647 45655 92002-16008 740801 

SA,, 45656 46630 

SP,, 46631 47450 

MS,, 47451 47744 

READF 47745 50472 92002-16006 740801 

REIO 50473 50575 92001-16005 741120 

RWNDF 50576 50657 92002-16006 740801 

LOCF 50660 51045 92002-16006 740801 

P.PAS 51046 51074 92002-16006 740801 

RWSUB 51075 51346 92002-16006 740801 

IPUT 51347 51367 92002-16006 740801 

CREA, 51370 51441 

GREAT 51442 51717 92002-16006 741022 

NAM,. 51720 52014 92002-16006 740801 

CK,SM 52015 52130 

ID, A 52131 52220 

MRISS 52221 52257 92002-16006 740801 

READ, 52260 52304 92002*16006 740801 

.XfER 52305 52350 

XWRIS 52351 52640 

SREAD 52841 53376 

,OPSY 53377 53436 

EOITR(0050)42002 46456 92002-16010 REV.C 750413 
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REIO 


46437 


46561 


92001« 


'16005 


741120 


CRgAT 


46562 


47037 


92002* 


'16006 


741022 


OPEN 


47040 


47225 


92002k 


'16006 


741205 


READF 


47226 


47753 


92002« 


'16006 


740801 


CLOSE 


477S4 


50062 


92002« 


'16006 


740801 


CLOSE 


47754 


50062 


92002- 


•16006 


74080 


SOPEN 


50180 


50366 


92002- 


'16006 


740801 


P. PAS 


50367 


50413 


92002- 


'16006 


740801 


RWSUB 


50416 


50667 


92002- 


'16006 


740801 


RWNDS 


50670 


51000 


92002- 


•16006 


740601 


R/WS 


51001 


51134 


92002- 


'16006 


740801 


,XFER 


51135 


51200 








RMPAR 


51201 


51223 








GETAO 


51224 


51241 








SP Ce)080)42P)02 


43377 








RNRQ 


43400 


43625 


92001- 


'16005 


741120 


KEIO 


43626 


43730 


92001* 


"16005 


741120 


KCVT 


43731 


43743 


92001<« 


'16005 


741120 


PARSE 


43744 


43763 


92001O 


•16005 


741120 


OPEN 


43764 


44151 


92002- 


'16006 


741205 


READF 


44152 


44677 


92002« 


•16006 


740801 


CLOSE 


44700 


45006 


92002" 


'16006 


740801 


POST 


45007 


45035 


92002- 


'16006 


740801 


SOPEN 


45036 


45244 


92002- 


'16006 


740801 


P. PAS 


45245 


45273 


92002- 


'16006 


740801 


RWSUB 


45274 


45545 


92002- 


'16006 


740801 


RWNDS 


45546 


45656 


92002- 


'16006 


740801 


R/W$ 


45657 


46012 


92002- 


'16006 


740801 


GICEX 


46013 


46114 








ST.LU 


46U5 


46244 


92002- 


•16001 


741025 


,ORCT 


46245 


46253 


92001- 


'16005 


741120 


GIROT 


46254 


46403 


92002- 


•16001 


741027 


GICDJ 


46404 


46770 








GICCJ 


46771 


47332 








GtCDS 


47333 


50662 


92002- 


•16001 


741030 


GIC?? 


50663 


51473 


92002- 


'16001 


741027 


GISTM 


51474 


51666 


92002- 


'16001 


740807 


CNUMO 


51667 


51706 


92001- 


•16005 


741120 


GP)QIP 


51707 


52122 


92002- 


•16001 


741007 


GICKS 


52123 


52712 








GICIN 


52713 


54174 








GREAT 


54175 


54452 


92002- 


'16006 


741022 


NAM,, 


54453 


54547 


92002- 


•16006 


740801 


GICDA 


54550 


55124 








PURGE 


55125 


55223 


92002- 


•16006 


740801 


,XFER 


55224 


55267 








RMPAR 


55270 


55312 








GETAO 


55313 


55330 









ASMS (0095)42002 47547 92060-16022 REV. 750420 

ASMBD(0099)47550 50356 92060-16023 REV, 750420 

ASMBl (0^99)47550 51544 92060-16024 REV, 750420 

A8MB2(0099)47550 52046 92060-16025 REV. 750420 

ASMB3(0099)47550 50637 92060-16026 REV. 750420 

ASMB4(0099)47550 51301 92060-16027 REV. 750420 
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XREP f009fi)42PII42 5024(9 92060-16028 REV. 750420 
,OPSY 50241 50300 



LOAORC0090)42002 53211 



92060.»16005 RF.V.A 750505 



HALT 11 m SET SWR & PRESS RUN 

RT PARTITION REQMTSI 
SMP 04 PAGES 
JOB 04 PAGES 
WHZAT 02 PAGES 
AUTOR 04 PAGES 

BG PARTITION REQMTSI 



FMGR 


06 


PAGES 


EDITR 


05 


PAGES 


GASP 


07 


PAGES 


ASMB 


06 


PAGES 


XREF 


05 


PAGES 



LOAOR 06 PAGES 

LARGEST ADDRESSABLE PARTITIONI 

W/0 COM 16 PAGES 

W/ COM 16 PAGES 



LWA MEM RESIDENT PROG AREA 45434 

ALIGN AT NEXT PAGE? 

YES 

LWA MEM RESIDENT PROG AREA 45777 

SYS AV MEMJ 01024 WORDS 

1ST OSK PG 00020 

CHANGE 1ST OSK PG? 
21 

SYS AV MEM! 02048 WORDS 

PAGES REMAININGI 00043 

DEFINE PARTITIONS 

l.4,RT 

2,4,RT 

3,14,BG 

4,7,BG 

5,7,BG 

6,7,aG 

/E 

MODIFY PROGRAM PAGE REQUIREMENTS? 

EDITR, 7 

ASMB, 14 

XREF, 14 

LOAOR, 14 

/E 

ASSIGN PROGRAM PARTITIONS? 
/E 
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SYSTEM STORED ON DISC 

SYS SIZEI 20 TRKS, 031 SECS(10) 

HALT 77 »» SET SWR & PRESS RUN 
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APPENDIX D 
SUMMARY OF EXEC CALLS 



ASSEMBLY LANGUAGE FORMAT 

EXT EXEC 



JSB EXEC 



DEF *+n+l 



DEF pi 



Used to link program 
to RTE-lIi: 



Transfer control to 
RTE-III 

Defines point of 
return from IRTE-III , n 
is number of 
parameters; must be 
direct address 

Define addresses of 
parameters which may 
occur anywhere in 
program; may be 
multi-level in- 
direct 



DEF pn 



return point Continue execution 
of program 



Pl - 



pn 



Actual parameter 
values 



For each EXEC call, this appendix includes only the 
parameters {pl through pn in the format above) of the 
Assembler Language calling sequence. 

FORTRAN/FORTRAN IV FORMAT 



CALL EXEC (7) 

-or- 
ICODE = 7 
CALL EXEC (ICODE) 



Equivalent 
calling sequences 



Where: 

p2 through pn are either integer values or integer variables 
defined elsewhere in the program. 

Note that some EXEC call functions are handled auto- 
matically by the FORTRAN compilers or special sub- 
routines. Refer to FORTRAN, Part 2 „ Section IV and 
the specific EXEC calls. 

READ/WRITE 



CALL EXEC ( ICODE, p2. ..pn) 



Purpose: 




Transfers input or output. 


Assembly: 




ICODE DEC 


1 = READ, 2 = WRITE 




17 = Class READ 




18 = Class WRITE 




20 = Class WRITE/READ 


ICNWD OCT 


Control Word, see Section 




m. 


IBUFR BSS 


Buffer of n words 


IBUEL DEC 


Same n\ words (+), charac- 




ters (-) 


IPRMl DEC p 


optional parameter. Used 




for disc track in disc 




call. 


IPRM2 DEC q 


optional parameter. Used 




for disc sector in disc 




call. 


ICLAS OCT 


Class Word, see Section 




III. 


FORTRAN: 




REG=EXEC(IC0DE,ICNWD,IBFR,IBFL,IP1,IP2,ICLS) 
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I/O CONTROL 



I/O STATUS 



Purpose: 






Carry out control 


operations 




Assembly: 






ICODE DEC 3 


or 19 


3 = Control 

19 = Class Control 


ICNWD OCT 




Control Word, see Sec- 
tion III. 


IPRAM DEC n 




(Optional parameter 
required by some 
CONWDs) 


ICLAS OCT 




Class Word, see Section 
III. 


FORTRAN: 






REG=EXEC(ICODE,ICNWD,IPRAM,ICLAS) 



CLASS I/O- GET 



Purpose 






Request 


device status. 




Assembly: 




ICODE 


DEC 21 




ICLAS 


NOP 


Class Word, see Section III 


IBUFR 


BSS 


Buffer of n words 


IBUFL 


DEC 


Same n; words (+), 
characters (-) 


IRTNl 


NOP 


Return for IPRMl 


IRTN2 


NOP 


Return for IPRM2 


IRTN3 


NOP 


Return for ICLAS 


FORTRAN: 




CALL EXEC(ICODE,ICLAS,IBUFR,IBUFL,IR 1 , 
IR2,IR3) 



Purpose: 




Request device status. 




Assembly: 




ICODE DEC 13 




ICNWD DECn 


Logical unit number 


ISTAl NOP 


Word 5 of EQT entry 




returned here 


ISTA2 NOP 


Optional parameter for 




word 4 of EQT 


ISTA3 NOP 


Optional parameter for 




LU status 


FORTRAN: 




CALL EXEC(IC0DE,ICNWD,ISTA1 ,ISTA2,ISTA3) 



DISC TRACK ALLOCATION 



Purpose: 






Request allocation 


of contig 


Lious tracks. 


Assembly: 






ICODE DEC 4 or 


15 


4 = Allocate track to 
program, or 15 = 
allocate track globally. 


ITRAK DECn 




Number of contiguous 
tracks desired. If bit 15 
= 1 , do not suspend 
until available. 


ISTRK NOP 




Starting track returned 
here, or -1, not 
available. 


IDISC NOP 




Disc logical unit 
returned here. 


ISECT NOP 




Number of 64 word 
sectors returned here. 


FORTRAN: 






CALL EXEC (ICODE,ITRAK,ISTRK,IDISC,ISECT) 
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DISC TRACK RELEASE 



PROGRAM COMPLETION 



Purpose: 






Release some disc tracks 


assigned to the program. 


Assembly: 






ICODE DEC 5 or 


16 


5 = Release program's 
tracks, or 16 = release 
global tracks. 


ITRAK DECn 




If = -1 , release all 
program tracks. If = n, 
the number of conti- 
guous tracks starting at 
ISTRK. 


ISTRK NOP 




Starting track number. 


IDISC NOP 




Logical unit. 


FORTRAN: 






CALLEXEC(ICODE,ITRAK,ISTRK,IDISC) 



Purpose: 




Signal end of program. 




Assembly: 




ICODE DEC 6 




INAME ASC 3, name 


Name of program to be 




terminated (0 if this 




one). 


INUMB DEC 


= Normal completion 




-1 = Serial resuability 




1 = Make dormant but 




save suspension point 




2 = Terminate on next 




schedule; save tracks. 




3 = Terminate immedi- 




ately and release tracks. 


IPRMl 


Up to 5 optional parameters 


IPRM5 




FORTRAN: 




REG = EXEC (ICODE, 


INAME,INUMB,IPRM1 . . IPRM5) 


CALL RMPAR (IPRMl 


. . IPRM5) pram pick-up 
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PROGRAM SUSPEND 



PROGRAM SCHEDULE 



Purpose: 

Suspend calling program . 

Assembly: 

ICODE DEC 7 

FORTRAN: 

PAUSE library subroutine generates this call. 



PROGRAM SEGMENT LOAD 



Purpose: 

Load segment of calling program. 

Assembly: 

ICODE DECS 

INAME ASC 3,x.x:.xjc;r a:.x:jcxjc is segment name 

IPRMl 

Up to 5 optional parameters 
IPRM5 

FORTRAN: 

REG = EXEC (IC0DE,INAME,IPRM1 . . IPRM5) 



Purpose: 

To schedule another program. 

Assembly: 

ICODE DEC 9 = Immediate, wait 

10 = immediate, no wait 

23 = queue, wait 

24 = queue, no wait 
INAME ASC 3,xxxxx xxxxx is the program name 
IPRMl 

Up to 5 optional parameters 



IPRM5 
IBUFR BSS 
IBUFL DEC 

FORTRAN: 



Optional buffer of n words 
Same n ; words (+) or 
characters (-) 



REG = EXEC(IC0DE,INAME,IPRM1 . . . IPRM5, 
IBUFR, IBUFL) 



TIME REQUEST 



Purpose: 




Request the 24-hour time 


and day. 


Assembly: 




ICODE DEC 1 1 




ITIME BSS 5 


Time values: tens of 




milliseconds, seconds, 




minutes, hours, day, 




returned in that order. 


I YEAR BSSl 


Year (optional) 


FORTRAN: 




CALL EXEC(ICODE,ITIME,IYEAR) 
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STRING PASSAGE 



TIMED EXECUTION (Absolute Start) 



Purpose: 




Pick up command string 


or pass buffer to "Father." 


Assembly: 




ICODE DEC 14 




IRCOD DEC 


l=retrieve command string 




2=pass buffer 


IBUFR BSS 


Buffer of n words 


IBUFL DEC 


Same n ; words (+) or 




characters (-) 


FORTRAN: 




CALLEXEC(ICODE,IRCOD,IBUFR,IBUFL) 



TIMED EXECUTION (Initial Offset) 



Purpose: 

Schedule a program to start after a delay 
Assembly: 
ICODE DEC 1 2 
DECO 



IPROG . ^ er^ ^ 

ASC 3, name 

IRESL DEC ;c 
MTPLE DEC;^ 
lOFST DEC-z 



Schedule calling program, 
or Schedule name 

Resolution code 

Execution multiple 

z (units set by x) equals 
the initial offset. 



FORTRAN: 
CALLEXEC(ICODE,IPROG,IRESL,MTPLE,IOFST) 



Purpose: 




Schedule a program to start at a particular time. 


Assembly: 




ICODE DEC 12 




IPRG \ . „„ ^ 

I ASC 3, name 


Schedule calling program, or 


Schedule name 


IRL DEC ;c 


Resolution code 


MT DEC 7 


Execution multiple 


IHRS DEC a 




MINS DECb 1 




> 

ISECS DEC c 


Defines absolute start-time 


MSECS DECc^ / 




FORTRAN: 




CALLEXEC(ICODE,IPRG,IRL,MT,IH,MI,IS,MS) 
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PROGRAM SWAPPING CONTROL 



LOGICAL UNIT LOCK 



Purpose: 




Allows program to lock 


itself into core. 


Assembly: 




ICODE DEC 22 




lOPTN DEC 


= swap OK 




1 = swap not OK 




2 = swap program only 




3 = swap all disc resi- 




dent area. 


FORTRAN: 




CALL EXEC (ICODEJOPTN) 



RESOURCE MANAGEMENT 



Purpose: 




Allows cooperating programs to manage resources. 


Assembly: 




JSB 


RNRQ 


ICODE OCT 


Control word, see Sec- 




tion III. 


IRN BSSl 


Resource number 


ISTAT BSSl 


Status of resource 


FORTRAN: 




CALL RNRQ(ICODE,IRN, ISTAT) 



Purpose: 




Locks an I/O device. 




Assembly: 




JSB 


LURQ 


lOPTN OCT 


OxOOOO=unlock specified lu 
lxOOOO=unlockall/M's 
0x000 l=lock with wait 
1x000 l=lock without wait 
(x is no abort bit) 


LUARY DEC 


Array of lu 's to be locked/ 
unlocked. 


NOLU DEC 


Number of lu's to be 
locked/unlocked. 


FORTRAN 




CALL LURQ(IOPTN,LUARY,NOLU) 



PARTITION STATUS 



Purpose: 




Return status on specified partition 


Assembly: 




ICODE DEC 25 




IPART DECn 


Partition number 


IPAGE BSS 1 


Starting page number return- 




ed here 


IPNUM BSS 1 


Number of pages returned 




here 


ISTAT BSS 1 


Partition status 


FORTRAN: 




CALL EXEC (ICODE,IPART,IPAGE,IPNUM,ISTAT) 
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APPENDIX E 
SUMMARY OF ERROR MESSAGES 



OPERATOR REQUEST ERROR MESSAGES 

When an operator request is in error, RTE-III rejects the 
request and prints one of the messages below. The operator 
enters the request again, correctly. 

Message Meaning 

OP CODE ERROR Illegal operator request word. 

NO SUCH PROG The name given is not a main 

program in the system. 



INPUT ERROR 



A parameter is illegal. 



ILLEGAL STATUS Program is not in appropriate 
state. 

CMD IGNORED-NO Not enough system available 
MEM memory exists for storing the 

program's command string. 
Re-enter the command (RU, 
ON, GO) or enter the inhibit 
(IH) form of the command. 

EXEC CALL ERROR MESSAGES 

When RTE-III discovers an error in an EXEC call, it 
terminates the program, releases any disc tracks assigned to 
the program, prints an error message on the operator 
console, and proceeds to execute the next program in the 
schedule list. 

When RTE-III aborts a program, it prints the following 
message: 

name ABORTED 

When a memory protect violation occurs that is not an 
EXEC call or $LIBX or $LIBR call, the following message 
is printed: {address is the location that caused the viola- 
tion.) 

MP name address 



When an EXEC call contains an illegal request code, the 
following message is printed: {address is the location that 
made the illegal call.) 

RQ name address 

An RQOO error means that the address of a returned 
parameter is below the memory protect fence. 

The following errors have the same format as "MP" and 
"RQ" errors. 

Error Meaning 

TI Batch program exceeds allowed time 

RE Re-entrant subroutine attempted recursion 

(call itself) 

DM Program tried to access a page not includ- 

ed in its logical memory (similar to MP) 

The general error format, for other errors, is: 

type name address 

where type is a 4-character error code 

name is the program that made the call 

address is the location of the call (equal to the 
exit point if the error is detected after the 
program suspends) 

ERROR CODES FOR DISC ALLOCATION CALLS 

DROl = Not enough parameters 

DR02 = Number of tracks is < zero; illegal logical unit; 
or number of tracks to release is zero or 
negative. 

DR03 = Attempt to release track assigned to another 
program 
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ERROR CODES FOR SCHEDULE CALLS 

SCOO = Batch program attempted tq suspend 
(EXEC(7)) 

SCOl = Missing parameter 

SC02 = Illegal parameter 

SC03 = Program cannot be scheduled 

SC03 INT name. Occurs when an external interrupt 
attempts to schedule a program that is already sched- 
uled. RTE-III ignores the interrupt and returns to the 
point of interruption. 

SC04 = name is not a subordinate (or "son") of 
the program issuing the completion call. 

SC05 = Program given is not defined. 

SC06 = No resolution code in EXECUTION TIME 

EXEC call (not 1,2, 3, or 4). 

SC07 = Prohibited core lock attempted. 

SCIO = Not enough system available memory for 
string passage. 

ERROR CODES FOR I/O CALLS 

1000 = Illegal class number. Outside table not 

allocated, or bad security code 

1001 = Not enough parameters 

1002 = Illegal logical unit or less than 5 parameters 

and X-bit set 

1003 = Not used 

1004 = Illegal user buffer. Extends beyond FG/BG 

area or not enough system memory to 
buffer the request 

1005 = Illegal disc track or sector 

1006 = Reference to a protected track; or using 

LG tracks before assigning them (see LG, 
Section II) 

1007 = Driver has rejected call 

1008 = Disc transfer longer than track 



IO09 = Overflow of load-and-go area 
ERROR CODES FOR PROGRAM MANAGEMENT CALLS 

RNOO = No option bits set in call 

RNOl = Resource number not defined 

RN02 = Resource number not defined 

RN03 = Unauthorized attempt to clear a LOCAL 
resource number 

ERROR CODES FOR LOGICAL UNIT LOCK CALLS 

LUOl = Program has one or more logical units locked 
and is trying to LOCK another with WAIT 

LU02 = Illegal logical unit reference (greater than 
maximum number) 

LU03 = Not enough parameters furnished in the call, 
logical unit reference less than one, or 
logical unit not locked to caller 

INPUT/OUTPUT ERROR MESSAGES 

ILLEGAL INTERRUPTS 

When an illegal interrupt occurs, RTE-III prints this message: 

ILLINTjcx 

Where xx is the octal channel number. 

RTE-III clears the interrupt flag on the channel and returns 
to the point of interruption. 

EQUIPMENT ERROR MESSAGES 

Message Meaning 

I/O ET L #x E #y S #z End-of-tape condition on LU #x , 

defined by EQT #y subchannel 
#z. Correct the condition and 
set I/O controller (EQT) UP. 

I/O TOL#xE#y S #z Device (LU #x) defined by EQT 

#y subchannel #z has timed out. 
Examine device. Correct problem 
and set I/O controller (EQT) UP. 

I/O NR L #:x: E #3^ S #z Device (LU #x) defined by EQT 

#y subchannel #z is not ready. 
Make it ready and set I/O con- 
troller (EQT) UP. 
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I/O PE L #x E #y S #z 



TR nnnn EQT eqt, 
Vpp S (or U) 



Where: 




nnn = 


Track number 


eqt = 


EQT number 


pp = 


Unit or sub- 




channel number 



Parity error in data transmission 
from device (LU #x) defined by 
EQT #y subchannel #z. 
Examine device. 

Irrecoverable disc transfer parity 
error. If the transfer is to a 
system or auxiliary disc the fol- 
lowing applies. 

a. If user request (U), then 
program is abnormally term- 
inated and track is made un- 
available for further opera- 
tions. If the user request was 
an on-line modification with 
the RTE-III loader, the parity 
error could be the result of 
failing to turn off the hard- 
ware disc protect switch. The 
loader should be executed 
again with the protect switch 
off. 

b. If system request (S), the 
program transfer terminates. 



If user request to peripheral disc, 
a transmission log of -1 is re- 
turned to the calling system. 



FORTRAN COMPILER ERRORS 

More than one source tape can be compiled into one 
FORTRAN program by leaving off the $END statement on 
all but the last source tape. When the end of each source 
tape is encountered (end-of-tape or EOT condition), RTE 
Driver DVROO can interpret it in two ways. An EOT can set 
the tape reader down (make it inactive), or not set it down. 
The action depends on how DVROO was configured during 



generation. In any case, an EOT does not suspend the 
FORTRAN compiler. Therefore, it is recommended that 
when compihng multiple tapes, DVROO be configured to 
set the tape reader down on EOT. For more information 
refer to the DVROO Manual (HP Part No. 29029-95001). 

If an EOT causes the tape reader to be set down, the RTE 
system will output a message to the operator: 

I/O ETL #x E #y S #z 

The operator must place the next source tape into the tape 
reader and set the tape reader up with the UP operator 
command. 

\J?,#x 

If an EOT does not cause the tape reader to be set down, 
the RTE-III System does not output any message and the 
compiler is not suspended. 

At the end of compilation (when the compiler detects the 
$END statement), the following message is printed. 

$END,FTN 

Two I/O error messages may be generated by RTE-III when 
FTN attempts to write on the LG tracks (RTE-III aborts 

FTN). 

IO06 

IO09 

IO06 means that the LG tracks were not defined by an LG 
operator request, and IO09 means that the LG tracks over- 
flowed. The operator must define more LG tracks with LG 
and start compilation over again. 

The compiler terminates abnormally if: 

a. No source file is declared by LS, although 
logical unit 2 is given for input. Compiler error 
E-0019 (FTN2), or ERROR 05 (FTN4)is printed on 
the Ust device. 
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b. The symbol table overflows. Compiler error 
E.0014 (FTN2), or ERROR 03 (FTN4) is printed on 
the Ust device. $END,FTN does not appear after the 
error message using FTN2, but does appear when 
using FTN4. 

ALGOL ERRORS 

More than one source tape can be compiled into one 
ALGOL program. When the end of each source tape is 
encountered (end-of-tape or EOT condition), RTE Driver 
DVROO can interpret it in two ways. An EOT can set the 
tape reader down (make it inactive), or not set it down. The 
action depends on how DVROO was configured during 
generation. In any case, an EOT does not suspend the 
ALGOL compiler. Therefore, it is recommended that when 
compiling with multiple tapes, DVROO be configured to set 
the tape reader down on EOT. For more information refer 
to the DVROO manual (HP Part No. 29029-95001). 



If an EOT causes the tape reader to be set down, the 
RTE-III System will output a message to the operator: 

I/O ETL #x E #y S #z 

The operator must place the next source tape into the tape 
reader and set the tape reader up with the UP operator 
command. 



name: fkHSExxxx 



Where: 



name = program name 

xxxx = a number which has no significance. 

Execution is then suspended. To restart the projp^am type: 

GO.name [,pl,pl,p3,p4,p5] 

See the GO operator command in Section II for a definition 
of the parameters. 

Two I/O error messages may be generated by RTE-III when 
ALGOL attempts to write on the LG tracks (RTE-III aborts 
ALGOL). 

IO06 

IO09 

IO06 means that the LG tracks were not defined by an LG . 
operator request, and IO09 means that the LG tracks over- 
flowed. The operator must define more LG tracks, with LG 
and start compilation over again. 



UP, #x 

If an EOT does not cause the tape reader to set down, the 
RTE-III System does not output any message and the com- 
piler is not suspended. 

At the end of compilation (when the compiler detects the 
ENDS statement), the following message is printed. 



SEND ALGOL 

If source input is indicated to be from the disc and the 
source pointer is not set, the diagnostic . 

NO SOURCE 



is printed on the system console and compilation ceases. 

At the end of a program, a program-termination request is 
made to the Executive. No message is printed. In case of a 
PAUSE statement, the following message is printed. 



ASSEMBLER ERRORS 

When a paper tape is being input through the tape reader, 
RTE-III Driver DVROO can interpret an end-of-tape (EOT) 
in two ways. An EOT can set the tape reader down (make it 
inactive), or not set it down. The action depends on how 
DVROO was configured during generation. In any case, an 
EOT does not suspend the Assembler. Therefore, it is 
recommended that when assembling multiple tapes, DVROO 
be configured to set the tape reader down on EOT. For 
more information refer to the DVROO manual (HP Part No. 
29029-95001). 

If an EOT causes the tape reader to be set down, the 
RTE-III system will output a message to the operator: 



I/O ET L #x E #y S #z 



The operator must up the tape reader with the UP operator 
command. 

UP, #x 
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If an EOT does not cause the tape reader to be set down, 
the RTE-III System does not output any message and the 
assembler is not suspended. 

At the end of assembly, the following message is printed: 

SEND ASMB 

If another pass of the source program is required, the 
following message appears at the end of pass one. 

SEND ASMB PASS 

the operator must replace the program in the input device 
and type: 

GO,ASMB 



If an error is found in the Assembler control statement, the 
following message appears: 

SEND ASMB CS 

The current assembly aborts. 

If an end-of-file condition occurs before an END statement 
is found (LS File only), the console signals: 

SEND ASMB XEND 

The current assembly aborts. 

If source input for logical unit 2 (disc) is requested, but no 
file has been declared (see LS, Section II), the console 
signals: 

SEND ASMB NPRG 



The current assembly aborts. 

RTE-III generates two messages when ASMB attempts to 
write on the load-and-go tracks (RTE-III aborts ASMB), 

IO06 

IO09 

IO06 means that the LG tracks were not defined by an LG 
operator request, and IO09 means that the LG tracks have 
overflowed. The operator must define more LG tracks with 
LG and start compilation over again. 



The next message is. associated with each error diagnostic 
printed during pass 1. 

#tape numb 

tape numb is the "tape" number where the error (reported 
on the next line of the listing) occurred. A program may 
consist of more than one tape. The tape counter starts with 
one and increments whenever an end-of-tape condition 
occurs (paper tape), or a blank card is encountered, or a 
zero length record is read from the disc. When the counter 
increments, the numbering of source statements starts over 
at one. 

Each error diagnostic printed during pass 2 of the assembly 
is associated with a different message: 

PG page numb 

page numb is the page number (in the listing) of the 
previous error diagnostic. 

PG 000 is associated with the first error in the program. 

These messages occur on a seperate line, above each error 
diagnostic in the listing. 



RELOCATING LOADER ERRORS 

Messages are printed in this format: 

/LOADR: message 
WARNING (W) MESSAGE 

W17 — Number of pages required by the program exceeds 
the partition size. The loader cannot find a partition 
large enough for the program. It can be relocated 
successfully but cannot be executed. You can 
generate a new system containing a partition large 
enough for the program or you can revise the program. 

"L" ERROR MESSAGES 



LOl — checksum error 
L02 — illegal record 



These errors are recoverable (except in Batch mode). The 
offending record can be reread by repositioning the tape 
and typing: 

GO, LOADR 
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L03- 
L04- 
L05- 
L06- 



L07 
LOS 



Memory overflow 
Base page linkage area overflow 
Symbol table area overflow 
Common block error 



a. Exceeding allocation in a replacement or addi- 
tion. 

b. In a normal background load, first program did 
not declare largest common block. 

Duplicate entry points 

No transfer address (main program) in the program 
unit. Another program may be entered with a GO 
operator request. (This also occurs when the 
LG track area is specified, but no program 
exists in that area.) 



L09 — Record out of sequence 



LI 6 - Illegal partition number. Value must be in 
the range from 1 through 64. 

LI 7 — Number of pages required by the program 
exceeds assigned partition size. A specific 
partition has been assigned for this pro- 
gram. The program requires more pages 
than are available in the partition. 

LI 8 - Total number of pages required exceeds 
32. The sum of required pages must be in 
the range from 1 through 32. 

ADDITIONAL MESSAGES 

NO BLANK ID SEGMENT 

This message is printed when no available (i.e., blank) ID 
Segment is not found. The loader calls for program 
suspension. The operator may then delete a program from 
the system (OF /iame,S operator request) or may terminate 
the loader. 

WAITING FOR DISC SPACE 

This message is printed when a track allocation cannot be 
made. The loader repeats the disc request and is suspended 
until space becomes available. 



LIO— Operator request parameter error. GO requests 
may be retyped; ON requests may not. 

LI 1 - Operator attempted to replace or purge a 
memory resident program. 

LI 2 - LG track area used without resetting (input option 
= 2 in "GO"). Input option was not specified as 99 
previously. 

LI 3 - LG track area has been illegally reset (i.e. over- 
written). Program addition on this area not allowed 
if it has already been specified for program input. 
Or area was once used for force loading with input 
option = 99 and it is again being used with input 
option = 99, (must = 2). 



UNDEFINED EXTS 

This message is printed followed by a list of all remaining 
undefined external symbols after a scan of the library. 
Additional programs may be loaded by the GO operator 
request. 



LOAD 

This message is printed and the loader is suspended 
whenever an End-of-Tape condition is detected from the 
input unit. 



LI 4 — Assembler or compiler produced illegal relocatable. 
A DBL record refers to an external which has not 
been defined (the original can not be found in the 
symbol table). 

LI 5 — Forward reference to a type 3 or type 4 ENT or to 
an EXT with offset which has not yet been 
defined, or a forward indirect external reference. 



DUPLICATE PROG NAME-name 

This message is printed when a program name is already 
defined in the system for a normal load or a program 
addition. The loader changes the name of the current 
program by replacing the first two characters with periods 
(e.g., JIMBl becomes .. MB 1). The second duplicate 
program name aborts the loader. 
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RTE-III Summary of Error Messages 

SET PRGM INACTIVE SYSTEM HALTS 

This message is printed when an end-of-tape condition is ^^^^^^^^ ^^^^^"^ ^^^^^ ^^® ^o^^^^ed within the protected sys- 

detected from the input device being used for library input ^^"^ ^'^^- ^^^^ ^'^ ^' f°^^«^^- 

and the loader needs the library to be scanned again. „ , „ 

rlalt K.eason 

At the end of a normal load, or after loading the last JSB EXC with memory protect off. 

segment, the loader prints the following message and 

terminates itself. 2 Tried to execute location 2. 

3 Tried to execute location 3 . 

/LOADR: name READY 

/LOADR: $END 4 System was in halt mode when power failed; 

or, no EQT entry for DVP43 power fail routine. 
LOAD LIB 

This message is printed when an end-of-tape condition is 
detected from the input device being used for library input 
and the loader needs to scan the library again. 
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APPENDIX F 
SUMMARY OF OPERATOR REQUESTS 



AB 



[:?] 



BL,[ lower limit, upper limit] 

BR, name 

DN '7' 

EQ,eqt 

EQ, eqt 



,UN 
,BU 



GO 



,name [,pl[,„.. . [,p5]J]]] 



GOIH 

IT, namef ,res,mptf ,hr,minf ,secf ,ms J J J J 

LG,numb 

LS, disc lu, trk numb 

LU, lu 

LU, lu ' fsubch numb J 



OF, name 
ON 



,0 

,1 



Abort current BATCH program. 

= save tracks 

1 = return tracks 

Sets buffer limits 

Sets a break flag in name 

Set EQT (I/O controller) or LU (I/O device) down. 



Print status of EQT entry eqt. 

UN = delete buffering 
BU = specify buffering 



Reschedule program name 

Schedule program to execute at specified tirnes. 

Allocate numb L & G tracks or release L & G tracks (numb = 0). 

Declare disc number disc lu, track number trk numb as source file. 

Print status of logical unit lu. 

Assign EQT number eqt (subchannel subch numb) to LU number lu. 

Terminate name = save tracks, 1 = return tracks, 8 = purge name 



,name [ ,NOW] [ ,pl [,... [ ,p5 ] ] ] ] ] Schedules name. NOW means ignore time values. 



ONIH 

PR,name,numb 
RU 



RUIH 
RT,name 

SS.name 

ST, name 



name [,pl[ , . . . [,p5]]]]] 



Set priority of name = numb 

Schedule program name 

Release name's tracks 
Suspend name 
Print status of name 
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ST Print name and partition number of current program 

oy , Prints name of current program in part numb. 

TI Print current real-time 

TM,year,dayf ,hr,mm,secj Specify year, day and 24 hour time. 

TO.eqt Print time-out value of EQT number eqt. 

TO,eqt, numb Assign time-out value numb to EQT number eqt 

UP,eqt Set EQT number eqt and any associated LU's up. 
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APPENDIX G 
HP CHARACTER SET 



Effect of Control key * 



r 



~\ 



r 



000-037B 



040-077B- 




100-1 37B 



-140-1778 



'7^^T 


\ 


\ 


°1 


"', 


'"0 


\ 


\ 


\ 


BITS 







1 


2 


3 


4 


5 


6 


1 


64 63 b2 b^ 

















NUL 


OLE 


SP 





@ 


P 




P 













1 


SOH 


DC1 


! 


1 


A 


Q 


a 


q 













2 


STX 


DC2 


" 


2 


B 


R 


b 


r 












3 


ETX 


DC3 


# 


3 


C 


S 


c 


s 





1 








4 


EOT 


DC4 


$ 


4 


D 


T 


d 


t 





1 







5 


ENQ 


NAK 


% 


5 


E 


U 


e 


u 





1 







6 


ACK 


SYN 


& 


6 


F 


V 


f 


V 





1 






7 


BEL 


ETB 


; 


7 


G 


w 


g 


w 













8 


BS 


CAN 


( 


8 


H 


X 


h 


X 












9 


HT 


EM 


) 


9 


i 


Y 


i 


y 












10 


LF 


SUB 


» 




J 


z 


i 


z 











11 


VT 


ESC 


+ 


; 


K 


[ 


k 


{ 




1 







12 


FF 


FS 


. 


< 


L 


\ 


1 


1 
1 




1 






13 


CR 


GS 


- 


= 


M 


] 


m 


} 




1 






14 


SO 


RS 




> 


N 


A 


n 


~ 




1 






15 


SI 


US 


/ 




? 











DEL 






32 CONTROL 
CODES 




V 


^ 




A 




\ 

64 CHARACTER SEl 
96 CHARACTER SEl 
128 CHARACTER SEl 


Upshifte 
Lower C 

^ 1 


d 
ase 

b 


r 






•■1 

























" 



EXAMPLE: The representation for the character "K" (column 4, row 11) is. 



b7 bg bg b4 bg bj b^ 
BINARY 10 10 11 



OCTAL 



1 



1 
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* Depressing the Control key while typing an upper case letter produces 
the corresponding control code on most terminals. For example. 
Control- H is a backspace. 
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HEWLETT-PACKARD CHARACTER SET FOR COMPUTER SYSTEMS 

This table shows HP's implementation of ANS X3. 4-1968 (USASCII) and ANS X3.32-1973. Some devices may substitute 
altemate characters from those shown in this chart (for example, Line Drawing Set or Scandanavian font) Consult the manual 
for your device. 

The left and right byte columns show the octal patterns in a 16 bit word when the character occupies bits 8 to 14 (left byte) or 
to 6 (right byte) and the rest of the bits are zero. To find the pattern of two characters in the same word, add the two values. For 
example, "AB" produces the octal pattern 040502. (The parity bits are zero in this chart.) 

The octal values through 37 and 177 are control codes. The octal values 40 through 176 are character codes. 



JO 
H 



Decimal 


Octal Values 


Mnemonic 


Graphic* 


Meaning 






Value 


Left Byte 


Right Byte 











000000 


000000 


NUL 


^ 


Null 


1 


000400 


000001 


SOH 


^ 


Start of Heading 


2 


001000 


000002 


STX 


^ 


Start of Text 


3 


001400 


000003 


ETX 


^ 


End of Text 


4 


002000 


000004 


EOT 


^ 


End of Transmission 


5 


002400 


000005 


ENQ 


^ 


Enquiry 


6 


003000 


000006 


ACK 


\ 


Acknowledge 


7 


003400 


000007 


BEL 


a 


Bell, Attention Signal 


8 


004000 


000010 


BS 


% 


Backspace 


9 


004400 


00001 1 


HT 


^ 


Horizontal Tabulation 


10 


005000 


000012 


LF 


•-F 


Line Feed 


11 


005400 


000013 


VT 


^ 


Vertical Tabulation 


12 


006000 


000014 


FF 


^F 


Form Feed 


13 


006400 


000015 


CR 


4? 


Carriage Return 


14 


007000 


000016 


SO 


^ 


Shift Out \ Alternate 


15 


007400 


00001 7 


SI 


=1 


Shift In ) Character Set 


16 


010000 


000020 


DLE 


^ 


Data Link Escape 


17 


010400 


000021 


DC1 


°i 


Device Control 1 (X-ON) 


18 


011000 


000022 


DC2 


°2 


Device Control 2 (TAPE) 


19 


011400 


000023 


DC3 


°3 


Device Control 3 (X-OFF) 


20 


012000 


000024 


DC4 


°4 


Device Control 4 (lAPb) 


21 


012400 


000025 


NAK 


^ 


Negative Acknowledge 


22 


013000 


000026 


SYN 


^ 


Synchronous Idle 


23 


013400 


000027 


ETB 


^ 


End of Transmission Block 


24 


014000 


000030 


CAN 


Sj 


Cancel 


25 


014400 


000031 


EM 


^ 


End of Medium 


26 


015000 


000032 


SUB 


% 


Substitute 


27 


015400 


000033 


ESC 


^ 


Escape^ 


28 


016000 


000034 


FS 


•^5 


File Separator 


29 


016400 


000035 


GS 


^ 


Group Separator 


30 


01 7000 


000036 


RS 


^5 


Record Separator 


31 


017400 


000037 


US 


^ 


Unit Separator 


127 


077400 


0001 77 


DEL 


m 


Delete, Rubout^ 



Decimal 
Value 



32 
33 
34 
35 
36 
37 
38 
39 

40 

41 
42 
43 
44 
45 
46 
47 

48 
49 
50 
51 
52 
53 
54 
55 

56 
57 
58 
59 
60 
61 
62 
63 



Octal Values 



Left Byte 



020000 
020400 
021000 
021400 
022000 
022400 
023000 
023400 

024000 
024400 
025000 
025400 
026000' 
026400 
027000 
027400 

030000 
030400 
031000 
031400 
032000 
032400 
033000 
033400 

034000 
034400 
035000 
035400 
036000 
036400 
037000 
037400 



Right Byte 



000040 
000041 
000042 
000043 
000044 
000045 
000046 
000047 

000050 
000051 
000052 
000053 
000054 
000055 
000056 
000057 

000060 
000061 
000062 
000063 
000064 
000065 
000066 
000067 

000070 
000071 
000072 
000073 
000074 
000075 
000076 
000077 



Character 



Meaning 



Space, Blank 

Exclamation Point 

Quotation Mark 

Number Sign, Pound Sign 

Dollar Sign 

Percent 

Ampersand, And Sign 

Apostrophe, Acute Accent 

Left (opening) Parenthesis 
Right (closing) Parentiiesis 
Asterisk, Star 
Plus 

Comma, Cedilla 
Hyphen, Minus, Dash 
Period, Decimal Point 
Slash, Slant 



Digits, Numbers 



Colon 
Semicolon 
Less Than 
Equals 
Greater Than 
Question Mark 
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Octal Values 






Decimal 






Character 


Meaning 


Value 


Left Byte 


Right Byte 






64 


040000 


000100 


@ 


Commercial At 


65 


040400 


000101 


A 


\ 




66 


041000 


000102 


B 






67 


041400 


000103 


C 






68 


042000 


000104 


D 






69 


042400 


000105 


E 






70 


043000 


000106 


F 






71 


043400 


000107 


G 






72 


044000 


000110 


H 






73 


044400 


0001 1 1 


1 






74 


045000 


000112 


J 






75 


045400 


000113 


K 






76 


046000 


000114 


L 






77 


046400 


000115 


M 






78 


047000 


000116 


N 




Upper Case Alphabet, 


79 


047400 


000117 







Capital Letters 


80 


050000 


000120 


P 






81 


050400 


000121 


Q 






82 


051000 


000122 


R 






83 


051400 


000123 


S 






84 


052000 


000124 


T 






85 


052400 


000125 


U 






86 


053000 


000126 


V 






87 


053400 


000127 


w 






88 


054000 


000130 


X 






89 


054400 


000131 


Y 






90 


055000 


000132 


z 






91 


055400 


000133 


[ 


Left (opening) Bracl<et 


92 


056000 


000134 


\ 


Backslash, Reverse Slant 


93 


056400 


000135 


] 


Right (closing) Bracket 


94 


057000 


000136 


A t 


Caret, Circumflex; Up Arrow" 


95 


057400 


000137 


*- 


Underline; Back Arrow* 





Octal Values 






Decimal 






Character 


Meaning 


Value 


Left Byte 


Right Byte 






96 


060000 


000140 


\ 


Grave Accent^ 


97 


060400 


000141 


a 


> 




98 


061000 


000142 


b 






99 


061400 


000143 


c 






100 


062000 


000144 


d 






101 


062400 


000145 


e 






102 


063000 


000146 


f 






103 


063400 


000147 


g 






104 


064000 


000150 


h 






105 


064400 


000151 


i 






106 


065000 


000152 


J 






107 


065400 


000153 


k 






108 


066000 


000154 


1 






109 


066400 


000155 


m 






110 


067000 


000156 


n 




Lower Case Letters^ 


111 


067400 


000157 









112 


070000 


000160 


P 






113 


070400 


000161 


q 






114 


071000 


000162 


r 






115 


071400 


000163 


s 






116 


072000 


000164 


t 






117 


072400 


000165 


u 






118 


073000 


000166 


V 






119 


073400 


000167 


w 






120 


074000 


000170 


X 






121 


074400 


000171 


y 






122 


075000 


000172 


z 






123 


075400 


000173 


{ 


Left (opening) Brace= 


124 


076000 


000174 


1 


Vertical Line= 


125 


076400 


000175 


} 


Right (closing) Brace^ 


126 


077000 


000176 




Tilde, Overline^ 
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Notes: 'This is the standard display representation. The software and hardware in your system determine if the control code is 
displayed, executed, or ignored. Some devices display all control codes as "||", "@", or space. 

^Escape is the first character of a special control sequence. For example, ESC followed by "J" clears the display on a 2640 
terminal. 

^Delete may be displayed as " ", "@", or space. 

■•Normally, the caret and underline are displayed Some devices substitute the up arrow and back arrow. 

^Some devices upshift lower case letters and symbols (^ through -~) to the corresponding upper case character ((g through 
A ). For example, the left brace would be converted to a left bracket. 



O 



CO 
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RTE SPECIAL CHARACTERS: 



Mnemonic 


Octal Value 


Use 


SOH (Control A) 


1 


Backspace 


EM (2600 Backspace) 
(Control Y) 


31 


Backspace 


BS (Control H) 


10 


Backspace 


EOT (Control D) 


4 


Simulate 
End Tape 
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APPENDIX H 
TAPE FORMATS 



H-l/H-2 



Tape Formats 



NAM RECORD 



15 



8,7 



CONTENT 
0,15 13,12 



0,15 





//// 


//// 


1 


^////// 


V////// 




RECORD 
LENGTH 




Wa 


D 
E 
N 
T 
001 


W/, 


VM 

m. 


CHECKSUM 



15 



WORD 1 
8,7 



0,15 



WORD 2 
8,7 



0,15 



WORD 3 
8,7 













y/A 


y//A 


s 


Y 


M 


B 


L 







WORD 4 



WORD 5 



WORD 6 



15,14 



0,15 



0,15 



WORD 7 



15 



0,15 



WORD 8 
0,15 



WORD 9 



0,15 



WORD 10 



WORD 11 



WORD 12 



WORD 13 



15 



0,15 



0,15 



0,15 



EXPLANATION 

RECORD LENGTH =9-60 WORDS 

IDENT = 001 

CHECKSUM: ARITHMETIC 
TOTAL OF ALL WORDS 
IN RECORD EXCLUDING 
WORDS 1 AND 3. 



SYMBL: FIVE CHARACTER 
NAME OF PROGRAM 





LENGTH OF 


LENGTH OF 


LENGTH OF 




MAIN PROGRAM 


BASE PAGE 


COMMON 




SEGMENT 


SEGMENT 


SEGMENT 




(OR ZERO) 


(OR ZERO) 


(OR ZERO) 



A/C: BINARY TAPE PRECESSION 
"■ =0 IF ASSEMBLER 

PRODUCED 

= 1 IF COMPILER 
PRODUCED 



PROGRAM 
TYPE 


PRIORITY 


RESOLUTION 
CODE 


EXECUTION 
MULTIPLE 



HOURS 


MINUTES 


SECONDS 


TENS OF 
MILLISECONDS 



15 



WORD 14 
8,7 



WORD 15 




WORD 16 
15 



WORD 17 
8,7 



COMMENT 
CHAR 1 



COMMENT 
CHAR 2 



COMMENT 
CHAR X 



COMMENT 
CHAR X 



WORD 18 



WORD n 
(n < 60) 



HATCH-MARKED AREAS SHOULD BE ZERO-FILLED 
WHEN THE RECORDS ARE GENERATED 



TODS— 14 
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ENT RECORD 



15 



8,7 



WORD 1 



CONTENT 
0,15 13,12 



4,3 



0,15 





Z^^/Z^^^^y 


1 

D 


y/// 


y///. 


E 
N 




RECORD 


yvvv/// 


E 
N 
T 


V/// 


V/// 


T 
R 


CHECKSUM 


LENGTH 


/yyy^vx 




y///. 


1 
E 






V/////A 


010 


//// 


'////. 


S 





WORD 2 



WORD 3 



EXPLANATION 

RECORD LENGTH = 7-59 WORDS 
IDENT = 010 

ENTRIES: 1 TO 14 ENTRIES 
PER RECORD; EACH ENTRY 
IS FOUR WORDS LONG. 



15 



8,7 



0,15 



0,15 



8,7 



WORD 4 



WORD 5 



WORD 6 



3,2 













/// 


V// 




s 


Y 


M 


B 


L 


1 


i 


R 



SYMBL: 5 CHARACTER ENTRY 
POINT SYMBOL 

R: RELOCATION INDICATOR 
= IN PROGRAM RELOCATABLE 
= 1 IF BASE PAGE RELOCATABLE 
= 2 IF COMMON RELOCATABLE 
= 3 IF ABSOLUTE 
= 4 INSTRUCTION REPLACEMENT 



15 



0,15 



0,15 



8,7 



UNRELOCATED 

ADDRESS 

FOR SYMBL OR 

REPLACEMENT INSTRUCTION 

VALUE 


S 


Y 


M 


B 



15 



WORD 7 



8,7 3,2 15 



WORDS 





WORD 10 



WORD 9 



0,15 







UNRELOCATED 
ADDRESS 

FOR SYMBL OR 
REPLACEMENT INSTRUCTION 
VALUE 

WORD 59 



WORDS 4 THROUGH 7 ARE 
> REPEATED FOR EACH 
ENTRY POINT SYMBOL. 



TODS— 15 
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Tape Formats 



EXT RECORD 



15 



8,7 



WORD 1 



CONTENT 



0,15, 13,12 



5,4 0,15 





y///, 


y///. 


1 

D 


/^:Z;%;^ 


E 
N 




RECORD 
LENGTH 


i 


M, 


E 
N 
T 
100 


'MM'. 


T 
R 
1 

E 
S 


CHECKSUM 



WORD 2 



WORD 3 



EXPLANATION 

RECORD LENGTH = 6-60 WORDS 

IDENT = 100 

ENTRIES: 1 TO 19 PER 
RECORD; EACH ENTRY 
IS THREE WORDS LONG 



15 




8,7 




0,15 




8,7 




0,15 




8,7 





































SYMBOL 




S 






Y 






M 






B 






L 






I.D. NO. 



WORD 4 



WORD 5 



WORD 6 



SYMBL: 5 CHARACTER 
EXTERNAL SYMBOL 

SYMBOL ID. NO.: NUMBER 
ASSIGNED TO SYMBL FOR 
USE IN LOCATING 
REFERENCE IN BODY 
OF PROGRAM. 



15 



8,7 



0,15 



0,15 




SYMBOL 
I.D. NO. 



WORD 7 



WORD 60 



WORDS 4 THROUGH 6 REPEATED 
> FOR EACH EXTERNAL 
SYMBOL (MAXIMUM OF 
19 PER RECORD). 

TODS— 16 
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DBL RECORD 



15 



8,7 



CONTENT 
0,15, 13.12 



8,7 6,5 



0,15 





""//// 


v//. 




V/ 


v/. 








RECORD 
LENGTH 


1 


p 


1 

D 
E 

N 

T 


i 


i 




NO. OF 

INST. 

WORDS 


CHECKSUM 



WORD 1 



WORD 2 



WORD 3 



EXPLANATION 

RECORD LENGTH - 6-60 WORDS 

IDENT-011 

Z/C: RELOCATION OF LOAD 
ADDRESS 

= 0FOR BASE PAGE 
= 1 FOR PROGRAM 
» 2 FOR ABSOLUTE 
= 3 FOR COMMON 

NO. OF INST. WORDS: 1 TO 45 
LOADABLE INSTRUCTION 
WORDS PER RECORD 



15 



0,15 13,12 10,9 7,6 4,3 1,015 



UNRELOCATED 

LOAD 

ADDRESS 


R 


R 


R 


R 


R 


r 
/ 
/ 
/ 
/ 
/ 
/ 


ABSOLUTE 
VALUE 



WORD 4 



WORDS 



INSTRUCTION WORD 
R = 000 



15,14 



0,15.14 



0,15,14 



15-BIT PROGRAM 

RELOCATABLE 

VALUE 



15-BIT BASE PAGE 

RELOCATABLE 

VALUE 



15-BIT COMMON 

RELOCATABLE 

VALUE 



D/1 



D/1 



^D/1 



INSTRUCTION WORD 
R = 001 



INSTRUCTION WORD 

R = dio 



INSTRUCTION WORD 
R =011 



RELOCATABLE LOAD ADDRESS: 
STARTING ADDRESS FOR 
LOADING THE INSTRUCTIONS 
WHICH FOLLOW; 

R's: RELOCATION INDICATORS: 

000 = ABSOLUTE 

001 = 15-BIT PROGRAM 

RELOCATABLE 
010= 15-BIT BASE PAGE 

RELOCATABLE 
Oil = 15-BIT COMMON 

RELOCATABLE 

100 = EXTERNAL REFERENCE 

101 = MEMORY REFERENCE 
110= BYTE REFERENCE 

R^ IS RELOCATION INDICATOR 
FOR INSTRUCTION W0RDi;R2, 
FOR INSTRUCTION WORD2; ETC. 



15,14 11.10 8.7 



0.15.14 11.10.9 



2.1.0. 15 



D/1: INDIRECT ADDRESSING 




EXTERNAL 

SYMBOL 

I.D. NO. 



•D/1 D/1 

INSTRUCTION WORD 

R = 100 



J 



EXTERNAL 

SYMBOL 

I.D. NO. 

-OR- 

ZERO 



UNRELOCATED 

VALUE 

-OR- 

OFFSET 



INSTRUCTION WORD 
R = 101 



15 



12 11 



2 10 15 



TYPE 



RELOCATABLE 

BYTE 

ADDRESS 



INSTRUCTION WORD R = 110 



= DIRECT 

1 = INDIRECT 

MEMORY REFERENCE INSTRUC- 
TIONS USE TWO WORDS. WITHIN 
THE TWO-WORD GROUP?. "MR" 
INDICATES RELOCATABILITY OF 
OPERAND SPECIFIED IN SECOND 
WORDS: 

00 = PROGRAM RELOCATABLE 

01 = BASE PAGE RELOCATABLE 

10 = COMMON RELOCATABLE 

11 = ABSOLUTE 



TODS— 17 



H-6 



Tape Formats 



END RECORD 



15 



8,7 



RECORD 
LENGTH 



WORD 1 



CONTENT 
0,15 13,12 



3, 2, 1,0, 15 




CHECKSUM 



WORD 2 



WORD 3 



EXPLANATION 

RECORD LENGTH = 4 WORDS 
IDENT= 101 



15 


14 


'/. 




^ 


RELOCATABLE 


TRANSFER 


^ 


ADDRESS 



WORD 4 



RELOCATION INDICATOR 
FOR TRANSFER ADDRESS 

= IF PROGRAM RELOCATABLE 
= 1 IF BASE PAGE RELOCATABLE 
= 2 IF COMMON RELOCATABLE 
= 3 IF ABSOLUTE 

TRANSFER ADDRESS 
INDICATOR 



IF NO TRANSFER 
ADDRESS IN RECORD 

1 IF TRANSFER ADDRESS 
PRESENT 



TODS— 18 
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ABSOLUTE TAPE FORMAT 



15 



87 



RECORD 
LENGTH 



WORD 1 



CONTENT 
01514 



15 




ABSOLUTE 

LOAD 
ADDRESS 



WORD 2 



INSTRUCTION 
WORD, 



WORD 3 



EXPLANATION 



RECORD LENGTH = NUMBER OF 
WORDS IN RECORD EXCLUDING 
WORDS 1 AND 2 AND THE 
LAST WORD. 

ABSOLUTE LOAD ADDRESS: 
STARTING ADDRESS FOR 
LOADING THE INSTRUCTIONS 
WHICH FOLLOW 



15 



15 




15 



INSTRUCTION 
WORD. 



CHECKSUM 



WORD n - 1 



WORD n 



INSTRUCTION WORDS: 

ABSOLUTE INSTRUCTIONS 
OR DATA 



CHECKSUM: ARITHMETIC 
TOTAL OF ALL WORDS 
EXCEPT FIRST AND LAST 



fOn paper tape, each word represents two frames arranged as follows: 

Bit 8 -* flf — Bit 

♦- Feed Holes 



Bit 15 — 



«• 






^ Bit 7 
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APPENDIX I 
RTE-II VS RTE-III 



RTE-III attempts to provide a user program environment 
the same as that in RTE-II. Most application programs 
developed for RTE-II and interfacing with the system only 
through documented, standard functions will run correctly 
under RTE-III. This appendix summarizes exceptions to 
this rule and other points of interest to RTE-II users. 



PRIVILEGED DRIVERS 

RTE privileged drivers must save and restore the state of 
the machine at interrupt. In RTE-II this includes the A,B, 
E and registers, the point of interrupt, and the state of 
memory protect. In RTE-III the state of the machine in- 
cludes these items plus the x and y registers and the status 
of the Dynamic Mapping System. In addition, if the 
privileged driver must access a user buffer which is in the 
program area, it must save, load, and restore the user map. 
See Section V. 



$REIO WITH DOUBLE BUFFERING 

In RTE it is possible for a program to make a double- 
buffered $REIO call. $REIO moves only the first buffer. In 
RTE-II the other buffer can remain in the program area or 
it can be separately moved to system available in memory 
with a $LIBR call. In RTE-III it is the user's responsibility 
to see that the second buffer is moved to System Available 
Memory. 



COMMUNICATIONS AREA 

Some of the words in the base page communications area 
that are static in RTE-II, are dynamic in RTE-III. Some of 
these are BKDRA, BKLWA, RTDRA, AVMEM, and FENCE. 
In RTE-III, these words are reset for each new program 
which is dispatched. See Appendix A for a complete list. 



COMMON USAGE 

A disc or memory resident program using the Real-Time 
or Background Common areas must declare common in 
order to have it included in its User Map. In addition, the 
total common area to be accessed must be declared in the 
main module for programs loaded at generation, or in the 
first relocatable module input to the loader for programs 
loaded on-line. In RTE-II it was possible for main programs 
and their segments to access different common areas (e.g. 
one using BG common, one using RT). This is not possible 
in RTE-III; type and size of common is determined once 
for the entire program. In RTE-II a Background program 
using Real-time (foreground) common could read but not 
modify that area; in RTE-III the fence is set to allow full 
access to the selected common area. 

FIXED-HEAD DISCS 

Fixed-head discs are supported in the RTE-II System. They 
are not supported in the RTE-III System. 

DEFAULT COMMON FOR ON-LINE RELOCATION 

If system common or reverse common is not specifically 
requested, local common is used without regard to program 
type. Refer to Section IV, Part 5, RTE-III Relocating 
Loader. 

INTERRUPT TRAP CELLS 

Due to DMS characteristics, instructions other than JMP 
and JSB must not be placed in a device's interrupt location. 
Execution of a non-transfer instruction (NOP,CLC,HLT,etc) 
may cause the interrupted program to continue under the 
wrong DMS Map. The privileged card (12620 A only) is not 
a device and does not interrupt. 



M 



RTE-III 



PROGRAM TYPES 

Table I-l is a chart summarizing the RTE-III program types. 
Note that several types have been added while 3 have been 
ob sole ted. 

The program type is used during generation to indicate 
various program characteristics. Program type is not used for 
programs loaded on-line; desired characteristics are specified 
through parameters to the loader. 



RTE-III allows the user to expand the program's primary 
type code to cover such features as access to real-time 
common by background programs and access to the sub- 
system global area (SSGA). The primary type code is ex- 
panded by adding 9,16, or 24 to the original number. For 
example, if you have a background disc resident program 
with a primary type code of 3 (it accessed background 
common or no common at all), and you wanted to modify 
it to access SSGA, you would change the type code to 19 
(add 16 to 3). 
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Table I-l . Summary of RTE-III Program Types 




EXECUTABLE PROGRAMS 



L_ . 

MEMORY RESIDENT* 


1 


1/ 










9 




\y 








17 






1/ 






17 








1/ 




25 










1^ 


REALTIME 
DISK RESIDENT* 


2 


l^ 










10 




1/ 








18 






1/ 






18 








u/ 




26 










\y 


BACKGROUND 
DISK RESIDENT* 


3 




1/ 








11 


\^ 










19 






1/ 






19 










1/ 


27 








1/ 
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[5 4_ 

[5 ^_ 

^^ ^_ 

^ ^ 

^1 ^ 

4 4_ 

4 ^ 

^ ^_ 

^ ^ 

£^ ^_ 

4 :4_ 

4 4_ 

^ ^_ 

4 ^ 
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SPECIAL PROGRAMS 



SYSTEM MODULE 



BACKGROUND SEGMENT 



SUBROUTINE 



SUBROUTINE 



SUBROUTINE 



SUBROUTINE 



SSGA MODULE 



(OBSOLETE) 



(OBSOLETE) 



(OBSOLETE) 



S 



z 



30 



12 



13 



DESCRIPTION 



MODULE TO BE LOADED WITH RESIDENT SYSTEM. PART OF HP SUPPLIED 
SYSTEM, USER-WRITTEN DRIVER, ETC. 



OVERLAY ABLE PROGRAM USED WITH BG DISK RESIDENT MAIN. COMMON 
TYPE FENCE ADDR, AND LOAD PT. DETERMINED BY MAIN. 



RELOCATED INTO RESIDENT LIBRARY IF CALLED BY ANY MEMORY 
RESIDENT PROGRAM. (UNCALLED 6'S BECOME 7'S) 



STORED ON DISK IN RELOCATABLE FORM. ANY PROGRAM CALLING 
A TYPE 7 HAS A COPY APPENDED TO IT. 



APPENDED TO CALLING PROGRAM. ALL TYPE 8 RELOCATABLES ARE 
DISCARDED AFTER GENERATION. 



RELOCATED INTO RESIDENT LIBRARY, WHETHER CALLED OR NOT. 
(FORCE LOADED) 



RELOCATED INTO SUBSYSTEM GLOBAL AREA OF SYSTEM. ACCESSIBLE 
ONLY TO PROGRAMS OF PROPER TYPE (ABOVE) 



CONVERTED TO TYPE 9 WHEN ENCOUNTERED. (DEFINED AS BG CORE 
RESIDENT W/BG COMMON IN RTE-II) 



CONVERTED TO TYPE 1 WHEN ENCOUNTERED. (DEFINED AS BG CORE 
RESIDENT W/RT COMMON IN RTE-II 



CONVERTED TO TYPE 5 WHEN ENCOUNTERED. (SEE TYPE 5) (DEFINED 
AS BG SEGMENT USING RT COMMON IN RTE-II) 



LOAD POINT & FENCE DEFINITIONS ( SEE FIGURE 6-3) 

L - NEXT AVAILABLE LOCATION DURING LOADING OF 

RESIDENTS. 
L, - 3RD WORD OF NEXT PAGE AFTER COMMON AREAS. 
U - 3RD WORD OF NEXT PAGE AFTER RESIDENT LIBRARY. 



F-, - FIRSTWORDOFSSGA. 

F2 - FIRSTWORD OF PAGE FOLLOWING RESIDENT LIBRARY. 

F3 - FIRSTWORD OF RT COMMON 

F4 - FIRSTWORD OF BG COMMON 

Fr - FIRSTWORD OF RESIDENT PROGRAM AREA. 



ADD 80 TO ANY OF THESE TYPES TO SPECIFY AUTOMATIC 
SCHEDULING AT SYSTEM STARTUP. 
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Abort program 2-2 
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ALGOL control statement 4-11 

ALGOL segmentation 4-33 

Allocate LG Tracks 2-6 

Answer tape 6-34 

ASCII character set 6-1 

ASCII, convert variable to 4-30 

Assembler control statement 4-14 

Assembler NAM statement 4-15 

Assembler segmentation 4-34 

Auto up, driver 5-9 

AUTOR 5-4 

Automatic scheduling 6-20 
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Background common 1-6 

Bad track information 6-18 

Base page 1-4 

Base page, system, planning 6-11 

Basic binary disc loader (BBDL) 6-6 

Binary to ASCII subroutine 4-30 

BINRY 4-29 

Blank ID segments (generator) 6-22 

Blank ID segments (loader) 4-21 

Brackets 2-1 

BREAD 4-29 

Break flag 2-3,4-31 

Break flag test subroutine 4-31 

Buffer, clear 2-5 

Buffer conversion subroutine 4-32 

Buffer limits 2-3,6-22 
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Table 6-5 6-15 

Buffering, planning 6-11 

BWRIT 4-29 
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Class number format — Figure 3-2 3-8 
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CNUMD 4-30 

CNUMO 4-30 
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COR.A 4-32 

Core lock 3-33,6-18 
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Current page linking 6-33 

Current time subroutine 4-32 



Data statement 

Day-of-year calendar 

DBL record 

De-allocate bit 

DEBUG 

Device reference table 5-2 

Device reference table, planning 

Direct memory access, planning 

Disc resident program area 

Disc resident program size 

Disc space allocation in RTE-III system - 

Figure A-2 

Disc tracks, release 

Disc transfer parity error 

DMA initialization 

Double asterisk (**) 

Down 

Driver auto up 

Driver completion section 

Driver completion section — Figure 5-3 

Driver identification, planning 

Driver initiation section 

Driver initiation section — Figure 5-2 

Driver processing of time-out 

Drivers, renaming 5-4, 

Driver sample — listing 
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READ/WRITE control word format - Figure 3-1 
Real-time and background common .... 
Records: 

NAM 

ENT 

EXT 

DBL 

END 

Re-entrant I/O 

Re-entrant subroutine structure 

REIO 

Relative address 

Release tracks 

Relocatable tapes, preparation of 

Renaming drivers 

Replace entry point 

Reschedule program 

Resource management 

Resource numbers 

Resource number format - Figure 3-6 . . 

Restarting generator 

Reverse common 4-19, 4-20 

RMPAR. . .2-5,2-8,2-9,3-2,3-7,3-22,3-23,3-25 

RN 

RNlock 

RNRQ 

RNxx error codes 

RTE-II vs RTE-III 
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